Skip to content
/ calendar Public

๐Ÿ“… effortlessly know when everyone in your team is available / busy with a single glance.

License

Notifications You must be signed in to change notification settings

dwyl/calendar

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

calendar

effortlessly know when everyone in your team is available / busy.

GitHub Workflow Status codecov.io Hex.pm contributions welcome HitCount

Why?

Viewing your team's availability in a single view is a time-consuming problem that all organizations face.

There are a few companies that have attempted to solve this problem in a variety of ways, however there is no "standard" or generally accepted solution to the problem

What?

Team calendar sharing simplified.

How?

Using the Google Calendar API, get the availability of all members of a team and display them in a single intuitive view.

Note: Please Ask lots of questions as issues in this repo: dwyl/calendar/issues
so that we can evolve the requirements/solution collectively.

For a step-by-step guide on how we built this, please see BUILDIT.md file.

Run the App

To run the app simply run these commands:

git clone git@github.com:dwyl/calendar.git
cd calendar
mix s

Now visit localhost:4000 in your web browser.

Google API Keys

To access the Google Calendar API you will need:

  1. a project setup in Google Console.
  2. Calendar API enabled.
  3. CLIENT_ID and CLIENT_SECRET in an .env file and export these as environment variables. This is so you can sign-in through Google. You may use .env_example's structure, rename it to .env and then run source .env to setup these env variables.

You can find more detail in the 2. Connecting to Google Calendar API section of the BUILDIT.md file.