> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tattoo.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Tattoo Developers

<img src="https://mintcdn.com/tattooco/AKQiPXZy4MVB9XLm/logo/tattoo-co-white-background.png?fit=max&auto=format&n=AKQiPXZy4MVB9XLm&q=85&s=f3cc0ca74eab362e4485cf6ce0a197f8" alt="tattoo.co chrome sigil" style={{ width: '104px', borderRadius: '28px', marginBottom: '24px', boxShadow: '0 24px 80px rgba(0,0,0,0.38)' }} width="250" height="250" data-path="logo/tattoo-co-white-background.png" />

Developer docs by Tattoo Company for governed TattooAPI surfaces across tattoo.co, Studio OS, and tattoo.dev.

These docs are intentionally dark-mode first: chrome-on-ink, glass panels, cyber-sigil accents, and a narrow public surface that does not overclaim what is live.

<CardGroup cols={2}>
  <Card title="Ontology Kernel" icon="diagram-project" href="/ontology-reference">
    The canonical tattoo domain model, projection contracts, trust posture, and review lanes.
  </Card>

  <Card title="API Surface Map" icon="route" href="/api-reference/surface-map">
    Public reads, authenticated beta reads, owner projections, and blocked write boundaries.
  </Card>

  <Card title="Studio Middleware" icon="network-wired" href="/guides/api-access-model">
    TattooAPI is the bridge between tattoo.co, Studio OS, managed websites, source packs, and future SDKs.
  </Card>

  <Card title="Governed Hydration" icon="shield-halved" href="/guides/data-hydration-source-packs">
    External data enters as source packs, then moves through review, preview, and approval before runtime truth.
  </Card>

  <Card title="Wave Gates" icon="gate-open" href="/guides/future-wave-gates">
    Public SDKs, pages, datasets, and intelligence tasks stay gated until runtime and review proof are ready.
  </Card>

  <Card title="Project Status" icon="chart-line" href="/project-status">
    Current access posture, public boundaries, beta reads, and launch constraints.
  </Card>
</CardGroup>

## Product Model

TattooAPI is not the Studio OS app and not the tattoo.co marketplace. It is the governed kernel between them.

* **tattoo.co**: consumer marketplace and booking conversion.
* **Studio OS**: private studio-owner operating app.
* **TattooAPI**: ontology, projections, access control, source-pack, and integration contracts.
* **tattoo.dev**: developer portal, SDKs, and app-channel documentation.

## What Exists Today

* A repo-native ontology package at `packages/domain-ontology`
* Generated reference material in `project-context/ontology`
* A governed runtime layer for internal execution, with remaining legacy paths being isolated
* A transitional public API surface for health and studios, with authenticated beta reads
* Internal SDK and operator workbench layers that are moving toward governed runtime truth
* A large studio, artist, and portfolio corpus that is being staged and normalized with explicit provenance
* Private worker and operator tooling that follows the same access boundaries as the API

## Build Order

<Steps>
  <Step title="Ontology First">
    Lock the object model, taxonomies, relationships, governance, and trust fields.
  </Step>

  <Step title="Normalize Data">
    Map the existing studio and artist corpus into canonical records with explicit `recordState`.
  </Step>

  <Step title="Stabilize API">
    Document and harden only the endpoints that are real today.
  </Step>

  <Step title="SDK and Tools">
    Project the stabilized contracts into SDKs, partner tools, and reviewed workflows.
  </Step>
</Steps>

## Start Here

* [Quickstart](/quickstart) for the current developer path
* [Project Status](/project-status) for the current wave posture and public boundaries
* [Trust Model](/trust-model) for provenance, verification, and visibility rules
* [Ontology Reference](/ontology-reference) for the source of truth
* [API Reference](/api-reference/introduction) for the supported current surface
* [Future Wave Gates](/guides/future-wave-gates) for the F+ activation model