# Streakline

> The AI-native gamification engine. Point a coding agent at your repo; it maps your app's real
> journeys into points, levels, streaks, achievements, and leaderboards. Fully hosted (Streakline
> Cloud). Scoring is versioned and recalculable over an immutable event log.

Streakline is deliberately focused: five primitives (events, points & levels, streaks, achievements,
leaderboards), not fifty. It is designed to be set up and operated by AI agents via a CLI, an MCP
server, and agent skills.

## Core concepts

- [How gamification works](/gamification): the engagement loop and the six primitives, explained.
- Events: immutable record of user actions; everything else is derived from them.
- Scoring: per-event multipliers plus optional streak / first-of-day / combo bonuses.
- Levels: progression curve driven by accumulated score.
- Streaks: daily/weekly cadences with freeze tokens to protect momentum.
- Achievements: tiered badges (bronze, silver, gold, platinum, diamond).
- Leaderboards: daily, weekly, all-time; individual or team; ranked in real time.
- Versioned scoring: named multiplier snapshots with forward / hybrid / full recalculation, audit, and rollback.

## Developer surfaces

- CLI: `npx streakline init` inspects the repo and drafts a scoring model; `streakline preview`, `streakline deploy`.
- MCP server: agents interact with Streakline natively over Model Context Protocol.
- Agent Skills: drop-in skills that wire gamification end-to-end.
- SDKs: TypeScript (server), Swift (iOS); REST API for everything else.

## API (v1)

- POST /api/v1/events — track an event (Bearer pk_ or sk_ key; supports idempotency keys)
- GET  /api/v1/users/:id/profile — score, level, streak
- GET  /api/v1/users/:id/achievements
- GET  /api/v1/leaderboards/:type — daily | weekly | monthly | all_time
- GET  /api/v1/challenges

Auth: `pk_` public keys are safe to embed in client apps; `sk_` secret keys are server-only.

## Hosting & pricing

Fully hosted on Streakline Cloud, metered by monthly active users:
Free (1,000 MAU) · Pro $20/mo (10,000 MAU) · Scale $200/mo (100,000 MAU) · Custom (SSO, SLA, data residency).

## Pages

- [Home](/): overview, the agent workflow, multi-platform install, templates.
- [How it works](/gamification): the gamification model in depth.
- [Example scoring report](/scoring-report): the living documentation the agent generates from a repo (features, journeys, charts, metrics vs target).
- [Roadmap](/roadmap): where Streakline is going.
- [Docs](/docs): integration guides, CLI, MCP, SDKs, and tech stack.
- [API reference](/api-reference): full REST reference, rendered with Scalar from [/openapi.json](/openapi.json).

## SDKs & platforms

Web (JS/TS), React, React Native / Expo, iOS (Swift), Android (Kotlin), Flutter,
Kotlin Multiplatform, Python (server), and raw REST. All are thin clients over the same API.

## What Streakline will not build (non-goals)

Raffles/quizzes/mystery boxes, a built-in email & push suite, a no-code marketing console,
per-seat pricing, hyperscale breadth, or owning your app's existing economy. The product stays
small, focused, composable, and developer-first — in the spirit of Resend and AgentMail.