Ulas
dd6c8a313a
Root cause 1 (scroll bleed): padding-top was applied to body in standalone mode. Since .app-shell has height: 100dvh, body-padding shifted the shell beyond the viewport bottom - enabling body-level scrolling. Fix: moved padding-top from body to .app-shell in the standalone media query. Root cause 2 (content overflow): fixed-height page containers (Calendar, Shopping, Meals, Notes, Budget, Contacts) calculated height as 100dvh - nav-bottom - safe-area-inset-bottom, but never subtracted the top safe area. This caused each page to overflow .app-content by exactly env(safe-area-inset-top) pixels in standalone mode. Fix: added --safe-area-inset-top token and subtracted it in all 6 height calculations. Service worker cache bumped to v27/v26.
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, Kanban view with one-tap status buttons for touch devices
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, configurable currency (13 currencies), 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, English, Italian, and Swedish UI with automatic locale detection
Quick Start
Option A — pre-built image (fastest, no clone required):
curl -O https://raw.githubusercontent.com/ulsklyc/oikos/main/docker-compose.yml
curl -O https://raw.githubusercontent.com/ulsklyc/oikos/main/.env.example
cp .env.example .env # edit .env — set SESSION_SECRET and DB_ENCRYPTION_KEY
docker compose up -d
docker compose exec oikos node setup.js
Option B — build from source:
git clone https://github.com/ulsklyc/oikos.git && cd oikos
cp .env.example .env # edit .env — set SESSION_SECRET and DB_ENCRYPTION_KEY
docker compose up -d --build
docker compose exec oikos node setup.js
Then open http://localhost:3000 and log in with the admin credentials you set in the previous step. Add family members from Settings.
New to Docker? The Installation Guide walks you through every step: From installing Docker to HTTPS setup, backups, and troubleshooting.
Tech Stack
-F7DF1E?style=flat-square&logo=javascript&logoColor=black){kind=icon}
Documentation
| Installation | Spec & Data Model | Contributing | Security | Changelog | Backlog |
|---|