HTML Anything

Standard Workflow

1. Understand the request. Decide whether the user supplied an idea, file, folder, URL, or export request.

2. Onboard exports when needed. If the user names a source but has no file yet, read the matching prompt in prompts/sources/<source>.md and give concise export steps. Stop after the export guidance unless the file is already available.

3. Inspect the source or brief.

   • For files/folders, read a representative sample and gather stats.
   • For URLs, fetch/inspect enough content to understand shape.
   • For ideas/briefs, create a structured content plan yourself. Use web verification for current or high-stakes facts.

4. Load guidance. Read prompts/styles/_design.md, prompts/styles/catalog.json, and the closest source prompt. If no source prompt fits, use prompts/sources/default.md. Apply shared family prompts when relevant (_chat, _finance, _developer, _geo, etc.). Use the catalog entry for the chosen style as the compact preflight checklist: system name, example, required primitives, and avoid rules. Then read and follow prompts/styles/<style>.md. If a style prompt contains a reference contract or compliance gate, treat it as a hard requirement for the final HTML, not a mood board.

   If the catalog entry names referenceHtml, read that file as well. If it only names an example, read examples/<example>/output.html when available. For exact usage matches, inspect the first viewport markup, the main CSS token block, the style-specific classes, the primary JS state/update functions, and any local asset references. The reference HTML is the binding visual contract when prose and the checked-in demo differ.

5. Choose auto style. Pick the page style internally. Do not ask the user to choose unless they explicitly want style options.

6. Extract the style contract. Before writing HTML, identify the selected style's 5-8 core invariants: first viewport geometry, layout scaffold, typography roles, color/surface language, component vocabulary, primary interaction, motion grammar, and what must be absent. Pull required primitives and avoid rules from catalog.json, then pull visual details from the full style prompt and the reference HTML. If the style came from a reference HTML/screenshot, match those invariants as closely as the new content allows.

7. Build the page. Create the HTML/CSS/JS directly. Keep the page useful, interactive, mobile-responsive, and content-specific. Include search/filter/copy where it genuinely helps. Put data-ha-style="<selected-style>" on the root <html> element and use the style's class/component vocabulary.

8. Generate assets when they improve the artifact. Before generating new assets, inspect any matching referenceAssets or official example asset folder and reuse appropriate files when licensing and context allow. Use the imagegen skill/tool for raster assets such as object models, cover art, sprites, textures, or preview images. Save project-bound assets into the output folder. Do not leave referenced assets only in $CODEX_HOME/generated_images.

9. Verify in a browser. For frontend artifacts, open the HTML via local file or local HTTP. Check:

   • page is nonblank,
   • desktop and mobile viewports render cleanly,
   • no obvious horizontal overflow,
   • contrast is readable and focus states are visible,
   • keyboard and touch paths exist for core interactions,
   • primary interactions work,
   • generated assets load. Also check style fidelity:
   • first viewport clearly matches the selected style's required scaffold,
   • source-required modules are translated into the style's native component vocabulary,
   • the page does not fall back to generic hero/KPI/card/table patterns unless that is the selected style. If any of these fails, revise the HTML before handoff.

10. Handoff. Give the user the local path or live link. Keep the explanation short.

Style Fidelity Gate

Before final handoff, the HTML must pass this internal checklist:

• The root <html> declares data-ha-style.
• The first viewport is built from the selected style's scaffold.
• If the selected style has a catalog referenceHtml, the generated first viewport visibly matches that reference's scaffold, token system, surface language, and interaction grammar unless the user explicitly requested a different style.
• At least four style-specific class names/components from the style prompt appear in the HTML.
• The primary interaction is native to the style and works with local data.
• Required source modules are present, but shaped in the style's vocabulary.
• Text contrast, focus states, keyboard access, and touch targets meet the UI quality gate.
• Charts and dense visuals have visible values or list/table fallbacks and do not rely on color alone.
• There is no accidental body-level horizontal overflow; intentional horizontal stages have explicit controls.
• Motion follows the style's motion grammar and respects prefers-reduced-motion.
• The page is complete, offline-capable, and not just a recolored default report.

If the page fails, revise the HTML before presenting it.

Design Requirements

Read prompts/styles/_design.md for Clockless tokens and apply them by default.

General requirements:

• Mobile-first responsive layout.
• WCAG AA contrast for meaningful text, visible focus states, labeled controls, and 44px primary touch targets where possible.
• Light + dark mode when the page is a report/data artifact; for app-like examples, a polished light-mode Clockless surface is acceptable.
• Inline CSS and JS in the HTML.
• No external JS/CDN dependencies unless the user explicitly allows them.
• The only default external font call is the Google Fonts import from prompts/styles/_design.md.
• Use generated bitmap assets when the experience needs rich visual subjects; use SVG/CSS/canvas for deterministic diagrams and UI.
• Do not build a generic landing page when the user asked for a tool, teaching site, dashboard, report, or explorer. Build the actual usable experience as the first screen.

Data And Privacy Defaults

• Treat generated HTML as sensitive as the source data because it may embed source records client-side.
• For intimate chats, do not include a raw-message appendix by default. Use aggregate charts and small anonymized evidence snippets.
• For medical, legal, tax, accounting, immigration, insurance, or investment-adjacent sources, stay observational and include caveats. Do not provide professional advice.
• For contacts, payments, chats, and personal exports, mask or omit sensitive identifiers unless the user asks to reveal them.
• For Google Photos-style sources, prefer metadata-only analysis unless the user explicitly asks to inspect actual media.

Sampling Guidance

Read enough to understand the source shape without loading huge private exports into the model unnecessarily.

• Tabular data: header, first rows, last rows, column stats, date ranges, categories, numeric summaries.
• Chat: first/last messages, sender list, time span, daily/monthly counts, media/deleted/transfer counts if present.
• Long text: headings, first sections, word count, section outline.
• Email: thread counts, sender counts, first/last messages, open loops.
• Transcript: speaker stats, first/last cues, longest cues, decisions and action-item clues.
• Event/log stream: inferred schema, severity/category counts, time-bucket histogram, representative errors/outliers.
• Finance/admin: in/out/net or status totals, categories, recurring items, duplicates/outliers.
• Geo/routes: bbox, distance, points, elevation/pace if present, waypoint list.
• Folder/repo: tree, README/index files, representative key files.

Source Prompts

The source prompts under prompts/sources/ contain export steps and content-specific analysis guidance. Use the closest one, then roll it up to the use-case taxonomy above:

• Teaching Studios: url-article, markdown, docx, pdf, default when the user wants a lesson, guided reading surface, or explainer.
• Conversation Analysis: wechat, whatsapp, slack, discord, telegram, imessage, multi-sender-chat.
• Personal Data & Places: amazon-orders, youtube-watch-history, spotify-history, iphone-health, kindle-highlights, twitch-history, browser-history, venmo-paypal-payments, linkedin-connections, vcard-contacts, chatgpt-export, claude-chat-export, ai-chat-export, notion-export, obsidian-vault, markdown-folder, google-maps-stars, google-photos-takeout, rideshare-history / travel history, gpx, kml, travel-itinerary, location-history.
• Files & Work Data: csv, json, jsonl, log, email, bank-transactions, invoices, quickbooks, ics-calendar, issue-tracker, trello-board, markdown, pdf, docx, bookmarks, url-list, reading-list, bibliography, medical-visit, lab-results, legal-chronology, git-diff, pr-review, ci-log, stack-trace, github-repo.
• General fallback: default.

If no prompt fits, proceed from prompts/sources/default.md and the user's brief.

Style prompts under prompts/styles/ define reusable page systems such as Timeline Story, Map Atlas, Network Map, Lesson Lab, Keepsake 3D Rhythm, Global Travel Map, Ops Console, Soft SaaS Console, Kami Longform Reader, Terminal CLI, Terminal Evidence Workbench, Mycelium Writing Environment (living-essay), Editorial Carousel, and Digital E-Guide Spread. They complement source prompts; they do not replace source-specific analysis. The style prompt is binding for the final HTML's layout and interaction system.