Compass Calendar

A daily planner for minimalists. Organize your day and lock-in.

Short.Demo.mov

Why Try Compass?

It'll help you get things done:

• Plan faster: Organize your Month → Week → Day in minutes.
• Keyboard-first: Shortcuts and command palette for lightning-fast planning.
• No bloat: A clean UI that does a few things well.

It'll be around for the long-term:

• Bootstrapped: VC-backed teams think in terms of months and funding rounds. We think in terms of decades and profit. We don't need to make $1B in 5 years or impress investors. As long as we keep users like you happy, we'll be fine.
• Vision: We have an ambitious vision and a practical roadmap that'll keep us busy for a long time.

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 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
• Google Calendar sync
• User sessions

The Limitations

• No UI to choose which Google calendars sync (only primary)
• No sharing, locations, reminders, or mobile app

Tech Stack

• Frontend: React, Redux, Tailwind CSS, TypeScript, Bun
• Backend: Node.js, Express, TypeScript, MongoDB
• Integrations: Google Calendar API, Google OAuth2, Server-Sent Events
• Testing: Bun, React Testing Library, Playwright

Getting Started

Option 1: Try Compass Online

app.compasscalendar.com ← No signup required.

Option 2: Run Compass Locally

# 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

Checkout the technical docs for all our developer guides.

Option 3: Self-host Compass

Run Compass on a server you control to keep everything on your infrastructure.

See the self-hosting guide for instructions.

Contributing

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

Issues: Create an issue to document a bug or feature request.

Pull Requests: Fork the repo, follow the the Contribution Guidelines, submit PR.

Feedback: Join the conversation on GitHub Discussions.

Resources

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

Star the repo for good luck =]