base on Spacepad is a beautifully simple room display app. Suitable for both small offices and larger deployments. # Spacepad Spacepad is a simple and fun meeting room occupancy display that helps you manage and visualize your meeting spaces effectively. Suitable for both small offices and larger deployments.  ## Our Mission Creating modern no-nonsense solutions for every office. Easy to use and affordable. While making meeting room management simple, intuitive, and enjoyable. ## Key Features - 🔄 **Real-Time Updates**: See room availability instantly - 📅 **Calendar Integration**: Works with Microsoft 365 - 🎨 **Fun Interface**: Engaging and intuitive display - 🚀 **Easy Setup**: Get up and running in minutes ## Why Spacepad? - 🔌 **Simple Integration**: Works with your existing calendar infrastructure - 📱 **Cross-Platform**: Access from any mobile device - 🌍 **Flexible Display**: Perfect for tablets and displays outside meeting rooms - ⚡ **Quick Status**: See room availability at a glance ## Quick Start ### Cloud Hosted Solution Looking to get started for free with zero effort? Visit [spacepad.io](https://spacepad.io) to try out our cloud-hosted solution. We offer a free 7 day trial. Cloud hosting is a great way to support this project for future development. ### Self-Hosted Option We value the open source and self hosted communities. After all, your privacy and data should be protected at all costs. To self host this application, you can deploy your own instance using Docker and Traefik out of the box. Using other reverse proxies will also work, but might require a bit more configuration. Get started setting up your own self hosted (production) instance: ```bash # Clone the repository git clone https://github.com/magweter/spacepad.git cd spacepad # Create the environment config cp .env.example .env ``` Set the app key for the application: ```bash # Linux sed -i "s/^APP_KEY=.*/APP_KEY=$(php -r 'echo "base64:".base64_encode(random_bytes(32));')/" .env # macOS sed -i '' "s/^APP_KEY=.*/APP_KEY=$(php -r 'echo "base64:".base64_encode(random_bytes(32));')/" .env # Windows (PowerShell) (Get-Content .env) -replace '^APP_KEY=.*', "APP_KEY=$(php -r 'echo "base64:".base64_encode(random_bytes(32));')" | Set-Content .env ``` Now open the .env file and configure your domain and email. You can log into the app using three different methods; Email, Microsoft (OAuth) or Google (OAuth). In order to use the regular email login you should configure an email provider, as it sends a 'magic link' by email. Edit the following variables: ```env MAIL_MAILER=smtp MAIL_HOST= MAIL_PORT=587 MAIL_USERNAME= MAIL_PASSWORD= MAIL_FROM_ADDRESS="[email protected]" ``` Configuring the following providers is optional, but you do require at least one. Leaving the client id of the provider empty will ensure it is not enabled. Configuring the Outlook provider: 1. Go to [Azure Portal - App Registrations](https://entra.microsoft.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade/quickStartType~/null/sourceType/Microsoft_AAD_IAM) 1. Click on 'New registration', add a name for the applicaton e.g. "Spacepad" and click 'register' 1. You will be taken to the Overview Page, record the "Application (client) ID" as this is the "AZURE_AD_CLIENT_ID=" 1. Click on the 'Authentication' tab and create two new 'web' platforms: - https://your-domain.com/outlook-accounts/callback - https://your-domain.com/auth/microsoft/callback 1. Save, and click on 'API-permissions' 1. Click 'Microsoft Graph', click 'Delegated permissions' and search for and select the following permissions `Calendars.Read.Shared`, `Place.Read.All` and `User.Read`. 1. Save, and click on 'certificates and secrets' 1. Create a new secret (not certificate) and copy the value 1. Click on 'overview' and copy the 'client id'. Beware: this is the client ID value you need, not the ID of the secret you just created. 1. Paste the values in the .env 'AZURE_AD...' variables Configuring the Google provider: 1. Go to [Google Cloud Console](https://console.cloud.google.com/) 1. Create a new project or select an existing one 1. Navigate to "APIs & Services" > "Credentials" 1. Click "Create Credentials" > "OAuth client ID" 1. Select "Web application" as the application type 1. Add authorized redirect URIs: - https://your-domain.com/google-accounts/callback - https://your-domain.com/auth/google/callback 1. Click "Create" 1. Enable the required Google APIs: - Go to "APIs & Services" > "Library" - Search for and enable: - Google Calendar API - Google Admin SDK API 1. Copy the Client ID and Client Secret 1. Paste the values in your .env file: - GOOGLE_CLIENT_ID=your_client_id - GOOGLE_CLIENT_SECRET=your_client_secret Now run the application using Docker Compose: ```bash docker compose -f docker-compose.prod.yml up -d ``` Great! You should now be able to access the application at http://localhost. Download the mobile app from the App Store or Play Store and follow the instructions 🚀 ### Enterprise Solutions We offer specialized support and modifications for enterprise deployments. Contact us at [email protected] for enterprise licensing and support options. ## Support Need help? We offer multiple support channels: - [Post an issue](https://github.com/magweter/spacepad/issues) - [Email Support](mailto:[email protected]) (for cloud hosted plans) ## License Spacepad is distributed under a dual-license model: - **Community Edition**: Available under the [Sustainable Use License](LICENSE.md) for non-commercial use - **Enterprise Edition**: Commercial license with additional features and support. See [Enterprise License](LICENSE_EE.md) for details. ## Contributing We welcome contributions! Please check our [Contributing Guide](CONTRIBUTING.md) to get started. ## Roadmap - [x] CalDav support - [ ] Custom display themes (colors & backgrounds) - [ ] Amazon Fire Tablet support - [ ] Multi-room dashboard view - [ ] Bookings rooms via the app ", Assign "at most 3 tags" to the expected json: {"id":"13900","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"