Flowcas - The Flow Calendar

Flowcas = Flow Optimised Calendar Auto Scheduler

What is this?

A browser extension which auto-schedules your day so you can get the most flow out of it. Connects to Google Calendar.

Requirements

• Mozilla Firefox 88 or Google Chrome 90
• node (v14.12.0)
• npm (v6.14.8)
• Any Windows, Mac or Linux distribution that can run npm v6.14.8

How to Build

1. npm install
2. npm run build
3. In the artifacts folder, you should see your ready to use addon.

How to Dev

Flowcas is a browser extension targeting Firefox and Chrome that uses Vue for its frontend.

This guide https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Build_a_cross_browser_extension has been followed for the most part to ensure both browsers can be hit. You could add support for other browsers in a pull request if you wanted :)

As a result of trying to do a cross-platform browser extension, we use Firefox for development. For more info as to why (the TL;DR is because of polyfilling between Chrome and Firefox) read the guide linked above.

To develop:

1. npm run serve in root directory.
2. Go to about:debugging (in Firefox, look up the equivalent for Google Chrome), This Firefox and click Load Temporary Add-on.... Select the manifest.json in the dist folder.

Spec

Plan Day Prompt

If the day hasn't been confirmed and the user is using the browser, trigger a fullscreen popup that prompts the user to start planning the day, skip for 10 minutes or ignore for the whole day.

Day Planner

1. Planning the day requires automatic events to populate the day a.k.a. a regular routine. The routine is expected to diverge, but to know of regular events or planned events is the first step. This is the first page of the app, the user can make adjustments to their regular routine.
2. The user is prompted to add any todos to their day.
3. The app then makes automatic adjustments to the events it can to optimise for the most amount of deep work time, which is essentially just a defragmentation process, with breaks added in between, aiming for around 3 hour work chunks. User can make manual adjustments after this.
4. User confirms and they go on with their day.

Event Notifications

When a calendar event triggers, FOCAS shows a full screen notification showing the event. The user can confirm "I'm doing the event", or, they can say "my day has got off track". If the day has got off track, the Day Planner runs again.

Credits

Notification loop: ringtone2-freesound.wav - Thoribass (https://freesound.org/people/Thoribass/sounds/254822/)