kws / book-a-booth

Social Finance's Book-A-Booth

This is a small, React-based app to makes it easier to find a free Zoom booth and book it. Rather than opening multiple calendars, or adding several schedules, this app shows booth availability as a heat map and allows booking of booths through a one-click (well, two click) approach.

This project is entirely "homemade" and contributions are very welcome!

You don't need to know how to code to get involved. Suggestions for improvements, user interface ideas, bug reports, every little suggestion will help us make this tool better and booking booths easier.

If you have a suggested improvement, please submit them in our issues log.

Join in the coding

This project was bootstrapped with Create React App which is a simple way of getting started with React. It's a great way to quickly get started if you want to play around in a blank project. You can see the start in the first commit.

Next, since this project requires logging in with Microsoft Office 365 and Microsoft have generously provided great sample applications for a range of different scenarios, I copied in the MS Authentication Layer React Router sample. You can (and try) this version in commit b1cac.

What do I need?

Patience. And a few tools. Most importantly you need Node.js. Follow the links to download a recent version of Node and install this.

Next, I highly recommend using Yarn for dependency management. Once you have working Node version installed, installing Yarn should be as easy as:

npm install -g yarn

Now you are ready to check out this project. If you're not familiar with GIT, try one of the many tutorials available online. For windows, I can recommend this one.

Once you have checked out this repository, install the required libraries:

yarn install

and then you are ready to launch the project itself:

yarn start

After a few seconds you should see a message like this:

Compiled successfully!

You can now view book-a-booth in the browser.

  Local:            http://localhost:3000
  On Your Network:  http://192.168.86.31:3000

Note that the development build is not optimized.
To create a production build, use yarn build.

The application may also automatically pop-up in your browser. You're now ready to start coding!