Skip to content
COHO
Atrium dev docs

COHO docs

Atrium

COHO

v1.1
App samples
AI Building

Build an Atrium app with AI

One minimised file with everything an AI tool needs: how to work, the hard rules, the full app contract and the design system. Upload it to any LLM, then describe your app.

ATRIUM-AI-BUILD.mdMarkdown
  1. Upload the file to ChatGPT, Claude, Cursor or any AI tool (or paste its contents).
  2. Describe the app you want in plain English.
  3. Let the AI ask you for the API key when it needs one.
View the file
Auto

ADK

The Atrium ADK

View .md

The ADK (app development kit) is everything needed to build an Atrium app: the runtime contract, the API, the starter samples, the rules and the design system. Every page here is short, dense Markdown, so you can hand it straight to an AI tool.

Get the ADK into your AI

  1. Copy the prompt and paste it into Claude, Cursor, ChatGPT or any AI coding tool. It points the tool at the whole kit, design included.
    Build me a COHO Atrium app.
First read this file in full. It has the instructions, the rules, the app contract and the design system: https://docs.coho.life/atrium-developer/ai-build.md
The app should: <describe what you want it to do>
  2. Or upload the file itself to tools without web access, or keep it in your repo or project knowledge.Download ATRIUM-AI-BUILD.md
  3. Point an agent at the index: https://docs.coho.life/atrium-developer/llms.txt. Every page is also available as Markdown from the buttons under its title.

Building screens? The Atrium design system opens in a new tab, with components you can copy.

What is in it

Section titled “What is in it”
Part What it covers Where
Runtime contract Manifest, signed calls, lifecycle, health, limits, permissions Developer guide
Samples Hello apps in Node, Python, Go and .NET Starter samples
Rules and suggestions What every app must do, and what makes it feel at home in COHO Rules
Design system Plain tokens and components for screens inside COHO Atrium design system (new tab)
Building with AI Prompts, Playground, staying safe Build with AI

Rules and suggestions

Section titled “Rules and suggestions”
  • Rule: required for apps COHO builds, and checked when any app asks for a public listing.
  • Suggestion: recommended for every app, so it fits inside COHO without having to look identical to it.

Third-party apps are free to go further than the suggestions. Rules exist where breaking them would hurt a customer or COHO.

Design

Section titled “Design”

Screens inside COHO (quick views and full app pages) should use the Atrium design system. It is deliberately plain: neutral colours, one type scale, simple components. It is not COHO’s own styling, which is for COHO’s internal developers.