Skip to content
Documentation
Getting Started

Getting Started

This guide will help you get KitaManager up and running quickly.

Prerequisites

Quick Start with Docker

The fastest way to get started is using Docker Compose:

# Start all services
docker compose up -d

This will start:

  • PostgreSQL database
  • KitaManager API server
  • Next.js frontend

Access the application at http://localhost:3000.

Development Setup

For local development:

# Install frontend dependencies
make web-install

# Build the API
make api-build

# Start development environment
make dev

Available Make Targets

CommandDescription
make devStart full development environment
make api-buildBuild the Go API
make api-testRun API tests
make web-installInstall frontend dependencies
make web-devStart frontend dev server
make swagger-docsGenerate API documentation

Default Credentials

After starting, you can log in with the default admin credentials:

FieldValue
Emailsuperadmin@example.com
Passwordsupersecret
Change the default password immediately in production environments!

Seed Data

The development environment includes seed data with:

  • A sample organization “Kita Sonnenschein” with three sections (Nest, Nestflüchter, Große)
  • ~120 children with care contracts and realistic age distributions
  • ~35 employees with employment contracts across all sections
  • Pay plans (TVöD-SuE 2024 and Minijob)
  • Budget items (parent contributions and operational costs)
  • Berlin state government funding rates
  • Three test users with different roles (superadmin, admin, manager)

Next Steps

Architecture