Features

## Everything your household needs

A complete set of tools designed for families, built to work together seamlessly.

📋

### Task Management

Shared tasks with deadlines, priorities, subtasks, recurring schedules, and a Kanban board with one-tap status buttons.

🛒

### Shopping Lists

Collaborative lists with aisle categories and one-click import from your meal plans.

🍽️

### Meal Planning

Weekly drag-and-drop planner with ingredient lists and automatic shopping list export.

📅

### Calendar Sync

Two-way sync with Google Calendar (OAuth) and Apple iCloud (CalDAV). All events in one place.

💰

### Budget Tracking

Track income and expenses, configurable currency (13 options), recurring entries, monthly trends, and CSV export.

📌

### Notes

Colored sticky notes with Markdown support. Perfect for family memos, recipes, and quick reminders.

📖

### Contacts

Shared family contact directory with vCard import and export.

🌐

### Works Everywhere

Installable as a PWA on any device. Works offline, supports dark mode, responsive from phone to desktop.

Preview

## See it in action

A clean, intuitive interface that adapts to your device and preferred theme.

Dashboard

Tasks

Meals

Shopping

Calendar

Budget

Notes

Contacts

Philosophy

## Built different, on purpose

No subscriptions, no vendor lock-in, no data leaving your home.

### Privacy First

AES-256 encrypted database with SQLCipher. Zero telemetry. Your data never leaves your server.

### Fully Self-Hosted

Runs on a Raspberry Pi, a NAS, or any server. Docker makes setup a one-liner.

### Zero Build Step

Pure ES modules, vanilla JS, plain CSS. No bundler, no transpiler, no framework. Ships what you write.

### Open Source

MIT licensed. Inspect, modify, extend, contribute. Built in the open for families who care about transparency.

Get Started

## Up and running in minutes

# Option A — pre-built image (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
# set SESSION_SECRET and DB_ENCRYPTION_KEY in .env
docker compose up -d
docker compose exec oikos node setup.js

Then open `http://localhost:3000` and log in. Need help? The Installation Guide covers everything from installing Docker to HTTPS, backups, and troubleshooting.