# Polaris Labs Docs

> Documentation for Polaris Labs — Flagpole feature flags and the Drift embedded key-value store.

- Documentation: https://pr-14-c0fdf0ef9f59.thally.app
- GitHub: https://github.com/thallylabs/polaris-labs-docs
- Full docs for LLMs: https://pr-14-c0fdf0ef9f59.thally.app/llms-full.txt
- Agent discovery (ai.txt): https://pr-14-c0fdf0ef9f59.thally.app/ai.txt
- Structured docs index (JSON): https://pr-14-c0fdf0ef9f59.thally.app/api/docs-index
- OpenAPI spec: https://pr-14-c0fdf0ef9f59.thally.app/openapi.yaml

## For AI agents

Every page supports content negotiation on its human URL:
- JSON API: append `?format=json` or send `Accept: application/json`
- JSON-LD: append `?format=ldjson` or send `Accept: application/ld+json`
- Markdown: append `?format=md` or send `Accept: text/markdown`
- Per-page API: https://pr-14-c0fdf0ef9f59.thally.app/api/docs/{page-id}
- Search API: https://pr-14-c0fdf0ef9f59.thally.app/api/search?q={query}
- Capability manifest (skill): https://pr-14-c0fdf0ef9f59.thally.app/skill.md
- Agent guidance (editing these docs): https://pr-14-c0fdf0ef9f59.thally.app/AGENTS.md
- MCP server (attach docs as native tools): https://pr-14-c0fdf0ef9f59.thally.app/api/mcp
- Agent readiness: https://pr-14-c0fdf0ef9f59.thally.app/api/agent-readiness

### Recommended workflow

1. Use this index, the search API, or `search_docs` before choosing a page.
2. Read the smallest set of relevant pages and follow their prerequisite links.
3. Treat the published docs as the source of truth. Label inferences and say when evidence is missing.
4. Cite the canonical human page URLs, not only API endpoints.
5. Use `/AGENTS.md` before editing a repository. The public MCP server is read-only.

## Get started

### Polaris Labs

- [Polaris Labs documentation](https://pr-14-c0fdf0ef9f59.thally.app/): Build with Flagpole feature flags and Drift embedded storage from one practical documentation set.
- [Quickstart](https://pr-14-c0fdf0ef9f59.thally.app/quickstart): Choose the shortest path to a working Flagpole service or a typed Drift store.
- [Choose a product](https://pr-14-c0fdf0ef9f59.thally.app/components): Decide whether your state belongs behind Flagpole's HTTP API, inside Drift, or in both layers.
- [Configuration](https://pr-14-c0fdf0ef9f59.thally.app/customization): Configure Flagpole's process and Drift's embedded store with their supported options.

## Flagpole

### Feature flags

- [Flagpole quickstart](https://pr-14-c0fdf0ef9f59.thally.app/flagpole/quickstart): Start Flagpole locally, create a release flag, and verify its evaluation over HTTP.
- [Flagpole concepts](https://pr-14-c0fdf0ef9f59.thally.app/flagpole/concepts): Understand default switches, percentage rollouts, environments, tags, history, persistence, and webhooks.
- [API overview](https://pr-14-c0fdf0ef9f59.thally.app/api/introduction): Orient yourself in Flagpole's JSON REST API and send a first request.
- [Authentication](https://pr-14-c0fdf0ef9f59.thally.app/api/authentication): Protect Flagpole's v1 routes with its optional static bearer token.
- [Flagpole API reference](https://pr-14-c0fdf0ef9f59.thally.app/guides/flagpole-api): Scan every Flagpole endpoint, its purpose, and the shared error contract.

## Drift

### Embedded storage

- [Drift quickstart](https://pr-14-c0fdf0ef9f59.thally.app/drift/quickstart): Install Drift, create a bounded TTL cache, and verify a value from a Node.js process.
- [Drift concepts](https://pr-14-c0fdf0ef9f59.thally.app/drift/concepts): Understand Drift's synchronous store, TTL expiry, LRU eviction, persistence, events, and batched writes.
- [Using namespaces](https://pr-14-c0fdf0ef9f59.thally.app/guides/using-namespaces): Create scoped Drift views without allocating separate stores or manually prefixing keys.
- [Store methods](https://pr-14-c0fdf0ef9f59.thally.app/api/store-methods): Reference every Drift store, namespace, batch, and transaction export in version 0.2.0.

## Guides

### Build with Polaris

- [Run the suite locally](https://pr-14-c0fdf0ef9f59.thally.app/guides/create-a-site): Start Flagpole, exercise Drift, and serve this documentation from sibling repositories.
- [Use Flagpole with Drift](https://pr-14-c0fdf0ef9f59.thally.app/guides/flagpole-with-drift): Keep Flagpole as the release source of truth while caching short-lived evaluation responses inside a Node.js service.
- [Validate changes](https://pr-14-c0fdf0ef9f59.thally.app/guides/work-with-the-cli): Run the focused checks for Flagpole, Drift, and this documentation before publishing a change.
- [Connect AI tools to Polaris docs](https://pr-14-c0fdf0ef9f59.thally.app/guides/connect-ai-tools): Give assistants the same reviewed Flagpole and Drift content that human readers use.

## Flagpole API

Interactive API reference available at https://pr-14-c0fdf0ef9f59.thally.app/api