🧭 Compass Calendar

A minimalist task manager designed for engineers.

All your tasks and events in one place. Organize your day, stay on track, and ship more code.

Why Use Compass?

It'll help you focus and ship faster:

• Plan faster: Organize your Month → Week → Day → Now in minutes.
• Keyboard-first: Shortcuts and command palette for lightning-fast navigation.
• Private & Offline: Runs fully local in your browser, with optional Google Calendar sync.
• No bloat: No AI — just a clean, minimal interface to help you get things done.

Join thousands of engineers who are staying organized and productive with Compass.

Short.Demo.mov

---

Features

The Unique Stuff

• Day Mode: See your tasks and events side-by-side
• Now Mode: Lock-in on a single task
• Custom Note: Display a personal note-to-self for motivation or reminders
• Someday/Maybe List: Organize future tasks without cluttering your schedule
• One-Click Adjustments: Move events forwards or back effortlessly

The Essentials

• Recurring events
• Command palette
• Event tagging, resizing, duplicating, reordering
• Drag & drop
• 2-way sync with Google Calendar (hosted or local via Ngrok)
• Google OAuth authentication
• User session management with Supertokens
• Email capture via Kit

Current Limitations

• Only supports primary Google Calendar (no sub-calendars)
• No sharing, locations, reminders, or mobile app (yet!)

We're actively working on improvements – check out our roadmap.

Getting Started

Try It Online

Head over to app.compasscalendar.com

No signup required — start planning instantly!

Run Locally

Want to poke around or run it self-hosted?

Read the technical docs: All the info you'd need to get started, including guides on how to install, test, build, deploy, and contribute.

Tech Stack

• Frontend: React, Redux, Tailwind CSS, TypeScript, Webpack
• Backend: Node.js, Express, TypeScript, MongoDB
• Integrations: Google Calendar API, Google OAuth2, Socket.io
• Testing: Jest, React Testing Library
• Other: Yarn workspaces for monorepo management

Contributing

We love contributions! Whether it's bug fixes, new features, or documentation improvements, your help makes Compass better for everyone.

Issues: Check open issues or create a new one. Pull Requests: Fork the repo, make your changes, and submit a PR. Follow our Contribution Guidelines. Discussions: Join the conversation on GitHub Discussions.

First-time contributors? Look for issues labeled "good first issue"!

Community & Resources

• Handbook: compasscalendar.notion.site
• Twitter: @CompassCalendar
• Youtube: Playlist
• LinkedIn: Compass Calendar

Star the repo for good luck.