Oikos

Self-hosted family planner for small households

Tasks · Shopping Lists · Meal Planning · Calendar Sync · Budget · Notes · Contacts

_{Toggle GitHub light/dark mode to see both themes.}

---

Highlights

📋 Task Management — Shared tasks with deadlines, priorities, subtasks, recurring schedules, and Kanban view

🛒 Shopping Lists — Collaborative lists with aisle categories and one-click import from meal plans

🍽️ Meal Planning — Weekly drag-and-drop planner with ingredient lists and shopping export

📅 Calendar Sync — Two-way sync with Google Calendar (OAuth) and Apple iCloud (CalDAV)

💰 Budget Tracking — Income and expenses, recurring entries, monthly trends, CSV export

📌 Notes & Contacts — Colored sticky notes with Markdown, contact directory with vCard import/export

⚡ Zero Build Step — Pure ES modules, no bundler, no transpiler, no framework. Ships what you write.

🔒 Privacy First — SQLCipher AES-256 encrypted database, fully self-hosted, zero telemetry

📱 PWA Native Feel — Installable on any device, works offline, dark mode, responsive from phone to desktop

🌍 Multilingual — German and English UI with automatic locale detection

---

Quick Start

git clone https://github.com/ulsklyc/oikos.git && cd oikos
cp .env.example .env       # Set SESSION_SECRET (≥32 chars)
docker compose up -d       # First build takes ~3 min (compiles SQLCipher)
docker compose exec oikos node setup.js   # Create admin account

Open http://localhost:3000 — add family members from Settings.

For HTTPS and reverse proxy setup, see nginx.conf.example.

---

Tech Stack

---

Documentation

📖 Spec & Data Model	🤝 Contributing	🔒 Security	📋 Changelog	📌 Backlog

---

Roadmap

✅ Core modules — Dashboard, Tasks, Shopping, Meals, Calendar, Notes, Contacts, Budget

✅ Calendar sync — Google Calendar + Apple iCloud bidirectional sync

✅ PWA — Service worker, offline mode, install prompt

📋 Push notifications for deadlines and reminders

📋 Household inventory tracking

---

License

_{Built with care for families who value privacy and simplicity.}