- move static mockups from resource/ui to mockup/ - move React app scaffold from resource/ui to app/ - move prome.md + images to docs/ - drop empty resource/jsonfile and resource/ - add root .gitignore - rewrite README for new layout - fix paths in mockup/index.html (resource/ui -> mockup, docs/prome.md)
3.8 KiB
Visual Design Contract
AGENTS.md is the canonical statement of the blank-canvas rule — check
app/routes/_index.tsx and app/global.css, preserve any real UI/brand
already there, and only treat the canvas as blank when those files still show
the starter's placeholder. This file does not restate that rule; it records
this app's visual direction. The fields below are the source of truth for
that direction: once filled in, read and preserve them on every build; while
they are still empty, the first substantial UI pass fills them in.
Non-negotiable: impress by default
When this app is still a blank canvas, every app generated from this template must look spectacular on first load, even when the build prompt gives no design direction. "Looks like a clean, intentional product" is the floor, not the goal. When no direction is supplied, you still commit to one — do not default to safe gray SaaS:
- Commit to one concrete visual world (see the
frontend-designskill and itsreferences/visual-direction.md). Do not ship the neutral placeholder theme. - Choose a product-fitting accent family and set it in the
app/global.csstokens for both light and dark. Never leave the 0%-saturation default as the shipped palette. - Establish a clear type hierarchy, a consistent spacing rhythm, and one signature detail (a considered empty state, a distinctive header, a crafted primary action) that makes the surface feel designed for its domain.
- Get focus, hover, empty, loading, and dark-mode states right — that polish is the difference between an AI demo and a product.
Pick a direction and execute it fully; never average toward generic SaaS. Once a direction is established and recorded below, preserve and extend it rather than starting over unless otherwise directed to.
Fill in before building the first surface
Once the fields below are filled in, they describe this app's established visual direction — read and preserve them on every subsequent build; do not re-derive a new direction. The first UI pass must fill these fields in as part of that build, not leave them as an empty template.
- Product mode:
persuade - Audience and cadence: indie film lovers browsing cinema details, occasional visits.
- Visual world (name + the feeling it creates): Friendly midnight arthouse lobby; dark screen with a warm crimson glow, rounded and inviting.
- Palette family + neutral undertone: deep crimson (#8F0808, #4C0404) on near-black #0D0D0D with warm #332B2B borders.
- Type treatment: Inter for body and headings; 'Jersey 15' pixel face for the AlterFlixHub wordmark.
- Composition: single-column page, 1224px max, image gallery, then 2-column info and sidebar cards.
- Shape language: 12px rounded cards, pill tags, circular icon badges.
- Anti-references (defaults this app must not drift toward): gray SaaS dashboards, light themes, sharp corners.
Agent-Native is structural, not visual
This shell already meets the Agent-Native contract: data in SQL, actions as the
single source of truth, application state for navigation/selection, and
real-time sync. Chat and the agent rail are opt-in, not default. Build the
product UI first. Add an AgentSidebar, a full-page chat route, or
sendToAgentChat handoffs only when the user asks for agent interaction — and
when you do, follow agent-native-toolkit and frontend-design → Agent
Surface And Page Boundaries so the surfaces are wired correctly.
Guardrails
- Keep semantic token names and shared component seams intact; express the direction through token values, type, spacing, and composition — not by forking the design system.
- Density comes from data, not prose. Subtract explanatory chrome; never subtract the visual craft that makes the app impressive.
- Compare against real products in the chosen mode, not against the starter.