| name | markdowntown-frontend |
| description | Frontend UX and design system guidance for markdowntown. Use when changing UI, layout, styling, typography, motion, or Tailwind classes, especially for Workbench, Atlas, and Library surfaces. |
markdowntown-frontend
Core workflow
- Identify the surface (Home, Atlas, Workbench, Library, Detail, Translate).
- Check design constraints and lint rules before editing styles.
- Apply changes with existing component patterns and tokens.
- Validate responsive layout and run lint/test commands.
Guardrails
- Avoid raw hex colors (lint:
pnpm lint:hex). - Avoid Tailwind neutral palette (lint:
pnpm lint:neutrals). - Prefer existing spacing/typography tokens and component primitives.
- Keep motion subtle and aligned with UX guidance.
References
- docs/DESIGN_SYSTEM.md
- docs/design/motion-responsive.md
- docs/design/sitewide-ui-audit.md
- docs/ux/primary-flow-spec.md
- codex/skills/markdowntown-frontend/references/design-system.md
- codex/skills/markdowntown-frontend/references/ui-ux.md