Repository files navigation

The open-source desk scheduling app for your office.Learn more.

We are the first open-source desk scheduling app for your office. Ever had conflicting desk schedules or an employee not getting their favorite desk? Tracking your desks in an Excel sheet? Use workplacify to manage your office desks and make your employees happy. A perfect alternative to Envoy, UnSpot, Flexopus or desk.ly.

• Next.js
• tRPC
• React.js
• Chakra UI
• Prisma

Meet us onDiscord orschedule a meeting with the founder.

1. Fork the repository:https://github.com/igeligel/workplacify/fork and clone it to your local machine:

   git clone https://github.com/<your_username>/workplacify

2. Go to the project directory:

   cd workplacify

3. Install packages with npm

   npm install

4. Set up your.env file:
   • Duplicate.env.example to.env
   • Create a newNEXTAUTH_SECRET, for example via:https://bitwarden.com/password-generator/
   • Generate theGOOGLE_CLIENT_ID andGOOGLE_CLIENT_SECRET viahttps://console.cloud.google.com/apis/credentials
   • If you want to use Microsoft as a login method, generate theMICROSOFT_ENTRA_CLIENT_ID,MICROSOFT_ENTRA_CLIENT_SECRET, andMICROSOFT_ENTRA_TENANT_ID viahttps://portal.azure.com/
   • Generate theCLOUDINARY_API_SECRET,CLOUDINARY_API_KEY, andCLOUDINARY_NAME viahttps://cloudinary.com/console
5. Setup Node If your Node version does not meet the project's requirements as instructed by the docs, "nvm" (Node Version Manager) allows using Node at the version required by the project. You can also usenvm-windows. We are currently using Node.js 20.
6. Start the database & development server:

   npm run db-upnpm run dx

7. Once starting you also should see an example organization id which you can join which has some static data already.

Deployment is done viarender.com. You can deploy your own instance by clicking the button below:

We are still working on our contributing guide but feel free to open a PR or issue if you see something or want to request a feature.

We are having some integrations of which some are necessary to run the application.

We use Google as the main auth provider. You can create your own OAuth credentials viahttps://console.cloud.google.com/apis/credentials. These credential can be then added to the.env file.

You can use Microsoft Entra as an auth provider.

You can create all the necessary credentials via theAzure Portal. Check forMicrosoft Entra ID in the search bar and select it.

On the next page, select "Add" and then "App Registrations" and then fill out the details. In the "Supported account types" section, choose:

• Accounts in this organizational directory only (Standardverzeichnis only - Single tenant) or
• Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox)

For the "Redirect URI (optional)", select "Web" and enter the following URL:https://127.0.0.1:3000/api/auth/callback/microsoft-entra-id. Or when you self-host:https://your-domain.com/api/auth/callback/microsoft-entra-id. The path is the important part here:/api/auth/callback/microsoft-entra-id.

Once created you need to find certain values and add them to the.env file:

We are using cloudinary to save images of the floor. We currently do not have other providers to save the image, but we might work on this in the future. You can create your own Cloudinary credentials viahttps://cloudinary.com/console. These credential can be then added to the.env file.

Discord is fully optional but we use it to notify the team around issues, or events that are happening on the platform, to interact with new users for example. You can create your own Discord bot viahttps://discord.com/developers/applications. These credential can be then added to the.env file.

The code is licensed under theMIT License mostly. Some parts are currently licensed under different licenses because they are commercial projects:

• Chakra Starter:PolyForm Strict License 1.0.0

None so far!