ArkOS Developer Portal

ArkOS is a Platform-on-Kubernetes — a config-driven SaaS platform for building and operating SaaS products. Define your product in YAML, and ArkOS handles subscriptions, entitlements, identity, tenancy, billing, and infrastructure.

What is ArkOS?

ArkOS turns platform engineering into a declaration problem. Instead of writing boilerplate microservices, you declare your product shape in meta/ YAML files, run arkgen generate, and get fully typed contracts, connectors, and documentation.

meta/
├── entities/       # Domain entities
├── modules/        # Feature modules
├── bundles/        # Product bundles
├── plans/          # Pricing plans
├── sagas/          # Orchestrated workflows
└── events/         # Domain events

Quick Links

Section	Description
Getting Started	Install ArkOS and build your first service
Architecture	How ArkOS components fit together
Reference	Auto-generated API and entity docs

Core Concepts

• Entities — Immutable domain objects defined in meta/entities/
• Modules — Feature modules that encapsulate business logic
• Bundles — Packaged sets of modules for distribution
• Plans — Pricing and entitlement configurations
• Sagas — Long-running orchestrated workflows

Philosophy

Config, not code. Declaration, not implementation. Contracts, not assumptions.

ArkOS is built on the principle that platform concerns (identity, tenancy, billing, entitlements) are solved problems. You should focus on your domain logic, not reinventing the wheel.