Home
Softono

Compass Calendar

Open source MIT TypeScript
223
Stars
65
Forks
105
Issues
2
Watchers
2 months
Last Commit

 About Compass Calendar

A simple, fast calendar.

Platforms

Web Self-hosted

Languages

TypeScript

Need Help Installing Compass Calendar?

We provide expert installation service for this software. Our team will install, configure, and secure Compass Calendar on your server. plans start at just $30.

Compass Calendar

View on GitHub

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