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

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

Tech Stack

• Frontend: React, Redux, Tailwind CSS, TypeScript, Webpack
• Backend: Node.js, Express, TypeScript, MongoDB
• Integrations: Google Calendar API, Google OAuth2, Socket.io
• Testing: Bun test (core), retained Jest suites (web/backend/scripts), React Testing Library, Playwright
• Other: Bun is the primary install/runtime/build entrypoint; webpack and Playwright are intentionally retained

Getting Started

Try It Online

Head over to app.compasscalendar.com. No signup required

Run Locally

Want to poke around or self-host?

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

Use Bun for dependency installation and the default repo commands. Bun now runs the CLI, backend dev flow, core tests, and package builds directly. Node.js 24+ is still required for retained tooling such as the web/backend/scripts Jest suites and the production Node build output.

Development Workflow

# Quick start
bun install
cp packages/backend/.env.local.example packages/backend/.env.local
bun run dev:web  # Frontend on http://localhost:9080
bun run dev:backend # Backend on http://localhost:3000

# Testing
bun run test:core && bun run test:web && bun run test:backend
bun run test:e2e

# Type checking and linting
bun run type-check
bunx prettier . --write

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.