🧭 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: Jest, React Testing Library
• Other: Yarn workspaces for monorepo management

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.

Development Workflow

# Quick start
yarn install --frozen-lockfile --network-timeout 300000
cp packages/backend/.env.local.example packages/backend/.env
yarn dev:web  # Frontend on http://localhost:9080
yarn dev:backend # Backend on http://localhost:3000

# Testing
yarn test:core && yarn test:web && yarn test:backend
yarn test:e2e

# Type checking and linting
yarn type-check
yarn 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.