# Kioku

A spaced repetition learning application (Anki clone) with PWA offline support and cloud sync.

## Features

- Spaced Repetition: FSRS algorithm for optimal learning scheduling
- Offline Support: Full PWA with IndexedDB local storage
- Cloud Sync: Automatic sync when online with conflict resolution
- Anki Import: Import existing .apkg decks from Anki

## Getting Started

### Prerequisites

- Node.js 22+
- pnpm 10+
- PostgreSQL 18+
- Docker
- Direnv (optional)

### Development

```bash
# Install dependencies
pnpm install

# Start containers
docker compose up

# Run database migrations
pnpm --filter server db:migrate

# Start development servers
pnpm dev
```

### Environment Variables

Create `.env` files in each app directory:

```pkgs/server/.env
DATABASE_URL=postgresql://user:password@localhost:5432/kioku
JWT_SECRET=your-secret-key
```

```pkgs/web/.env
PUBLIC_API_URL=http://localhost:3000
```

## Scripts

```bash
pnpm dev          # Start all apps in development
pnpm build        # Build all apps
pnpm test         # Run tests
pnpm lint         # Lint code
```

## Documentation

See [docs/dev/architecture.md](docs/dev/architecture.md) for detailed architecture documentation.

## License

MIT