Fluxure
Open-source intelligent calendar scheduling — automatically places habits, tasks, and focus time on Google Calendar with a greedy scoring engine. Self-hostable. SvelteKit + Express + PostgreSQL.
Fluxure
Open-source intelligent calendar scheduling
Fluxure automatically places habits, tasks, meetings, and focus time on Google Calendar. A greedy scheduling engine scores candidate time slots and syncs via the Google Calendar API.
Features
- Habits — Recurring activities with flexible frequency and preferred time windows
- Tasks — Deadline-driven work, auto-chunked into manageable blocks
- Focus Time — Protected deep work blocks
- Public Booking — Shareable scheduling links with availability detection
- Quick-Add — Natural language parsing ("Gym MWF 7am 1h")
- Quality Score — Weighted 0-100 metric for schedule health
- PWA — Installable with offline caching and real-time sync
- Billing — Free and Pro tiers with Stripe, 14-day trial
Meetings are modeled (types, API, DB) but currently gated — not placed by the scheduling engine. Scheduling-engine integration is planned, not shipped.
Architecture
pnpm monorepo with five packages (dependency DAG: shared → engine → api, and shared → web/landing):
packages/
shared/ Types, constants, enums, NL parser, plan limits
engine/ Pure scheduling algorithm (no DB/auth/I/O)
api/ Express + Drizzle ORM + PostgreSQL
web/ SvelteKit (Svelte 5) PWA
landing/ SvelteKit static marketing site
Quick Start
cp .env.example .env # configure DATABASE_URL, JWT_SECRET, Google OAuth
pnpm install && pnpm dev
- API: http://localhost:3000
- Web: http://localhost:5173
Or with Docker: docker compose up -d
Tech Stack
| Layer | Technology |
|---|---|
| Frontend | SvelteKit (Svelte 5), SCSS, Vite |
| Backend | Express, Node.js, PostgreSQL, Drizzle ORM |
| Auth | JWT (httpOnly cookies), Google OAuth |
| Calendar | Google Calendar API (push + polling) |
| Payments | Stripe |
| Infra | Docker, GitHub Actions CI, Vitest |
Documentation
License
