Git Product home page Git Product logo

workplacify's Introduction

workplacify

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

Banner for the GitHub repository, showing application screenshots

About the Project

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, or desk.ly.

Built With

Contact us

Meet us on Discord or schedule a meeting with the founder.

Development

Setup

  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:
  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 use nvm-windows. We are currently using Node.js 20.
  6. Start the database & development server:
    npm run db-up
    npm run dx
  7. Once starting you also should see an example organization id which you can join which has some static data already.

Deployment

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

Deploy to Render

Contributing

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.

Hacktoberfest

We will be active maintainers during the Hacktoberfest. In 2024 we will focus on this.

Integrations

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

Google OAuth

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

Cloudinary

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 via https://cloudinary.com/console. These credential can be then added to the .env file.

Discord (for notifications)

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 via https://discord.com/developers/applications. These credential can be then added to the .env file.

License

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

Acknowledgements

None so far!

workplacify's People

Contributors

igeligel avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.