https://github.com/SwitchbackTech/compass

🧭 Weekly planner for minimalists who value their time
https://github.com/SwitchbackTech/compass

calendar google google-calendar google-calendar-api google-calendar-integration google-calendar-synchronization minimalist nodejs react scheduling shortcuts time-management typescript

Last synced: about 1 month ago
JSON representation

🧭 Weekly planner for minimalists who value their time

• Host: GitHub
• URL: https://github.com/SwitchbackTech/compass
• Owner: SwitchbackTech
• License: mit
• Created: 2023-09-27T20:40:53.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2025-08-30T22:16:52.000Z (about 1 month ago)
• Last Synced: 2025-08-30T23:29:15.331Z (about 1 month ago)
• Topics: calendar, google, google-calendar, google-calendar-api, google-calendar-integration, google-calendar-synchronization, minimalist, nodejs, react, scheduling, shortcuts, time-management, typescript
• Language: TypeScript
• Homepage: https://www.compasscalendar.com
• Size: 9.26 MB
• Stars: 194
• Watchers: 4
• Forks: 46
• Open Issues: 96
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md
  • Agents: AGENTS.md

Awesome Lists containing this project

• awesome-useful-projects - <img src="https://icon.horse/icon/github.com" height="20px" align="center"/>/SwitchbackTech/compass - Calendar app (Productivity / Other)
• awesome-useful-projects - <img src="https://icon.horse/icon/github.com" height="20px" align="center"/>/SwitchbackTech/compass - Calendar app (Jump To / Productivity)

README

          
# 🧭 Compass Calendar

_Compass is a weekly planner that integrates with Google Calendar._



---

![Build](https://github.com/SwitchbackTech/compass/actions/workflows/test.yml/badge.svg)

![React](https://img.shields.io/badge/react-%2320232a.svg?style=for-the-badge&logo=react&logoColor=%2361DAFB) ![TypeScript](https://img.shields.io/badge/typescript-%23007ACC.svg?style=for-the-badge&logo=typescript&logoColor=white) ![NodeJS](https://img.shields.io/badge/node.js-6DA55F?style=for-the-badge&logo=node.js&logoColor=white) ![Google Cloud](https://img.shields.io/badge/GoogleCloud-%234285F4.svg?style=for-the-badge&logo=google-cloud&logoColor=white) ![MongoDB](https://img.shields.io/badge/MongoDB-%234ea94b.svg?style=for-the-badge&logo=mongodb&logoColor=white) ![Redux]() ![Socket.io](https://img.shields.io/badge/Socket.io-black?style=for-the-badge&logo=socket.io&badgeColor=010101)

![Webpack](https://img.shields.io/badge/webpack-%238DD6F9.svg?style=for-the-badge&logo=webpack&logoColor=black) ![Yarn](https://img.shields.io/badge/yarn-%232C8EBB.svg?style=for-the-badge&logo=yarn&logoColor=white) ![Styled Components](https://img.shields.io/badge/styled--components-DB7093?style=for-the-badge&logo=styled-components&logoColor=white)

![Jest](https://img.shields.io/badge/-jest-%23C21325?style=for-the-badge&logo=jest&logoColor=white)

![Testing-Library](https://img.shields.io/badge/-TestingLibrary-%23E33332?style=for-the-badge&logo=testing-library&logoColor=white)

## Features

The basics:

- 🔄 Recurring events (limited support)

- ⚡ Command palette

- ⚡ Shortcuts

- 🕒 Display events in local time

- 🏷️ Tagging events

- 🖍️ Resizing events

- 🖍️ Duplicating events

- 🖍️ Reordering tasks

- 🖍️ Drag & drop

The unique stuff:

- ✍️ Display your weekly goal

- ☑️ Someday / Maybe task list

- ⏩ Move an event forward/back with one click

Integrations:

- 🔄 **Hosted** 2-way sync with Google Calendar

- 🔄 **Local** 2-way sync with Google Calendar (Ngrok proxy)

- 🔐 Google OAuth authentication

- 🔐 User session management (Supertokens)

- ✉️ Email capture (Kit)

## Limitations

This calendar is a work in progress that might not have everything

you need yet, including:

- Sub-calendars (only primary calendar is supported)

- Sharing

- Location

- Reminders

- Mobile app

## Get Started

All the info you'd need to get started is at [docs.compasscalendar.com](https://docs.compasscalendar.com), including guides on how to install, test, build, deploy, and contribute.

[![NextStep-TheDocs](https://github.com/user-attachments/assets/3a41c035-6058-4cb0-97d0-4a03388355aa)](https://docs.compasscalendar.com)

## Next Steps

✍️ [Sign Up for the Waitlist](https://www.compasscalendar.com/waitlist)

🧭 [Use the App](https://app.compasscalendar.com) (Closed beta). Access to the **hosted** version of Compass is currently limited to emails that have been invited from our waitlist. This restriction is skipped when you're running the app **locally**.

💬 [Join our Discord](https://www.discord.gg/H3DVMnKmUd)

📃 [Read the Docs](https://docs.compasscalendar.com)

👀 Follow us on [X (Twitter)](https://x.com/CompassCalendar), [YouTube](https://youtube.com/playlist?list=PLPQAVocXPdjmYaPM9MXzplcwgoXZ_yPiJ&si=jssXj_g9kln8Iz_w), [LinkedIn](https://www.linkedin.com/company/compass-calendar)