# AIDHD app authoring directory
> Public, model-independent instructions. Reading them grants no deployment access.

- https://aidhd.nl/build/README.md — platform guide and deployment workflow
- https://aidhd.nl/build/app-contract.json — machine-readable contract and file index
- https://aidhd.nl/build/checklist.md — build and verification checklist
- https://aidhd.nl/build/starter.zip — public static starter
- https://aidhd.nl/build/example/ — working static example

Obtain any SSH connection and private operating details from the owner separately. Default audience is the private playground.


<!-- AIDHD BRAND STANDARD -->
Design/navigation/icon and mobile launcher requirements are in README.md and checklist.md. Use lowercase aidhd, original vector symbols, and the trusted shared shell; never duplicate navigation or promise automatic installation on iPhone.
Product glossary and UX hierarchy are in README.md/checklist.md. Use Admin, My apps, Build, Learn and the shared navigation. Platform features and app management are not standalone app tiles.

## Current experience contract — 2 November 2026
- My playground is personal: members see only projects they own. Sophie sees Built by me and Built by others, with creator names. The public homepage collection is separate.
- Show Draft, Building, Pending approval, Published or Failed. Link separately to Open app and Edit in Build. Only the creator may delete an unpublished, idle project, after confirmation; withdraw pending review. Published deletion stays in Admin.
- The shared toolbar has Back, Refresh, Home, My playground, Admin and More on mobile. Label Admin simply Admin. Retain its owner-only access checks. Refresh reloads the current app without signing out.
- Signed-out navigation to Playground, Build and Admin uses https://aidhd.nl/enter/playground/, /enter/build/ and /enter/admin/. These are real public welcome pages; their explicit Sign in button leads to the protected destination. Direct protected bookmarks still invoke Cloudflare. Never weaken private data access to customise an entrance.
- Public preview must use these same public entrances, never a pretend logged-out page.
- Canonical visible app addresses are https://playground.aidhd.nl/<registered-slug>/. Preserve legacy addresses as redirects and preserve standalone domains including eat.aidhd.nl. Private clean routes verify the signed Cloudflare identity before serving data; assets and APIs retain their access guards.
- Every generated app supplies app.json icon_path (original SVG path d data, 64x64 viewBox, command letters/numbers only; max 1500 characters), icon_color (#RRGGBB) and icon (short noun). Platform validates and renders it as 180/192/512px launcher artwork and favicon. Artwork must be distinct, simple, bold, no emoji. Shared wrapper owns navigation, manifests and installation guidance. Test the final published wrapper, not just the sandboxed app preview. Icon failures must never take an app offline.
- Rating dots are equal-sized drawn circles, not font glyphs.