suwappubot / showcase
CLAUDE.md4 starsChanged 3 months agoApache-2.0View on GitHub
Read this before touching ANY page in showcase/. The recurring failure this file exists to stop: new or edited pages picking up components/styles from an older design era, so they render with a different brand than the rest of the site (wrong nav, wrong palette, "some old library" look). Every page MUST use, unless it already deliberately doesn't: - Nav: @/components/SummerNav — sticky glass bar (light rgba(255,255,255,.78) base that composes with dark pages), persimmon logo, "Launch Terminal" CTA. This is…
In this repository19 other files it gives its agents.
- AGENTS.mdAGENTS.md
- .codex/AGENTS.mdAGENTS.md
- api-ts/CLAUDE.mdCLAUDE.md
- bot/CLAUDE.mdCLAUDE.md
- CLAUDE.mdCLAUDE.md
- webapp/CLAUDE.mdCLAUDE.md
- gitbook/llms.txtllms.txt
- suwappubot-conventionsSkill
- aegis-goalSkill
- design-iterateSkill
- ethglobal-goalSkill
- evolveSkill
- goalSkill
- handoffSkill
- redesign-existing-projectsSkill
- reflectSkill
- suwappubot-conventionsSkill
- design-taste-frontendSkill
- suwappuSkill
The file
We split this CLAUDE.md into the rules it gives an agent
4 rules. About 0 are common, 2 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 3
Read this before touching ANY page in showcase/.
- Distinctive: line 10
Every page MUST use, unless it already deliberately doesn't:
- Distinctive: line 59
Every link/CTA you add must be clicked or curl-verified — no dead buttons, no placeholder hrefs, no invented URLs.
- Very specific: line 61
All four locales (messages/en|fr|es|zh.json) updated together when copy changes.
≈ “Common” is an estimate: at least 1 in 5 of the 28,029 CLAUDE.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
showcase/CLAUDE.md — design-system canon
Read this before touching ANY page in showcase/. The recurring failure this
file exists to stop: new or edited pages picking up components/styles from an
older design era, so they render with a different brand than the rest of the
site (wrong nav, wrong palette, "some old library" look).
The canonical system ("summer")
Every page MUST use, unless it already deliberately doesn't:
- Nav:
@/components/SummerNav— sticky glass bar (lightrgba(255,255,255,.78)base that composes with dark pages), persimmon logo, "Launch Terminal" CTA. This is the ONLY nav for new pages. - Footer:
@/components/SummerFooter. - Tokens/classes: the
summer-*classes (summer-page,summer-shell,summer-kicker,summer-button,summer-actions,summer-code) defined insrc/app/summer-token-vars.css/site.css, plus themkt-*layout classes andinstitutional-*section classes (both belong to the current era and compose with summer tokens). - Type: the site's existing stack (serif display = Newsreader via the summer tokens; Archivo for body/UI; mono for labels). Never add a new font without a brand decision (see docs/design/serif-decision.md).
Legacy — do NOT use on new pages
@/components/Navigation(+NavDrawer,NavMenuData) — the old light nav ("Sign in / Talk to sales / Open Bot"). ~20 older interior pages still import it (about, pricing, research, contact, legal, docs layout, …). Do not copy imports from those pages; migration to SummerNav is tracked separately — don't grow the legacy set.src/app/classic/— the archived previous home page. Reference only.src/app/hero-a…hero-e— hero experiments. The live home importshero-d/hero-d.css; treat the others as dead.
Known traps
- No CSS reset is emitting anywhere.
globals.cssuses Tailwind v3 directives (@tailwind base) but the build runs the v4 PostCSS plugin, so Preflight never renders. UA defaults (body margin, etc.) are live on every route — set explicit margins/box-sizing; don't assume a reset. Repo-wide fix is a separate tracked task. .home-section/.home-heroareborder-boxnow — keep any new section containerbox-sizing: border-boxor its padding will overflow mobile and be silently clipped by.hd { overflow: clip }.next.config.mjsredirects/engine /terminal /hyperliquid /tempoto home anchors — thoseids must keep existing on/.- The hero's LiveQuote widget needs
SUWAPPU_DEMO_KEYand demo-agent credits; without them it renders an honest "unavailable" state. Never mock it.
Definition of done for any visual change
bun run buildpasses (bun only — never npm/npx/tsc).- Render locally (
bun run start, localhost bypasses the sandbox proxy) and screenshot desktop 1440 + mobile 390. Compare the nav and palette against/— if they differ, you imported the wrong era. - Mobile
document.documentElement.scrollWidthmust equal the viewport width, AND spot-check right-edge text isn't clipped (overflow:clip can hide it). - Every link/CTA you add must be clicked or curl-verified — no dead buttons, no placeholder hrefs, no invented URLs.
- All four locales (
messages/en|fr|es|zh.json) updated together when copy changes.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

