Skip to content

SwitchbackTech/compass-calendar

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2,397 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Compass Calendar

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

week-view-2026-06

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

Current things we don't support:

  • Subcalendar sync (only primary calendar)
  • Sharing, reminders, locations
  • Mobile app

Tech Stack

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

Getting Started

Option 1: Try Compass Online

compasscalendar.com ← No signup required.

Option 2: Run Compass Locally

# Quick start
bun install
cp compass.example.yaml compass.yaml # then replace the placeholder values
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

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.

Resources

About

A simple app to manage your calendar & tasks.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors