Platform Overview

The Swarm Platform is the shared foundation every app is built on.

What It Contains

Component	Description
core_services	Shared Dart package — API clients, auth, data models
ui_kit	Design tokens, Figma-matched widgets, theming
demo_app	Reference app showing core_services + ui_kit in action
CI/CD templates	Shared .gitlab-ci.yml templates for all app repos

Stack

• Framework: Flutter (Dart)
• Monorepo: Melos
• API clients: Dio + interceptors
• Versioning: Melos + Conventional Commits
• CI/CD: GitLab CI on self-hosted runner (Docker)

Architecture

The platform follows a strict core/app boundary:

demo_app (or any app)
    └── depends on → core_services
    └── depends on → ui_kit

Apps never implement their own networking, auth, or design primitives. They consume core_services and ui_kit.

→ See Architecture for the full decision.

Getting Started

git clone https://gitlab.swarm-labs.org/swarm/platform/core.git
cd core
dart pub global activate melos
melos bootstrap

→ See Contributing for full setup instructions.