ai-spector 0.3.5 → 0.3.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (237) hide show
  1. package/README.md +32 -21
  2. package/assets/themes/airbnb/DESIGN.md +246 -0
  3. package/assets/themes/airbnb/SUMMARY.md +7 -0
  4. package/assets/themes/airtable/DESIGN.md +89 -0
  5. package/assets/themes/airtable/SUMMARY.md +7 -0
  6. package/assets/themes/apple/DESIGN.md +313 -0
  7. package/assets/themes/apple/SUMMARY.md +7 -0
  8. package/assets/themes/binance/DESIGN.md +345 -0
  9. package/assets/themes/binance/SUMMARY.md +7 -0
  10. package/assets/themes/bmw/DESIGN.md +180 -0
  11. package/assets/themes/bmw/SUMMARY.md +7 -0
  12. package/assets/themes/bugatti/DESIGN.md +268 -0
  13. package/assets/themes/bugatti/SUMMARY.md +7 -0
  14. package/assets/themes/cal/DESIGN.md +259 -0
  15. package/assets/themes/cal/SUMMARY.md +7 -0
  16. package/assets/themes/claude/DESIGN.md +312 -0
  17. package/assets/themes/claude/SUMMARY.md +7 -0
  18. package/assets/themes/clay/DESIGN.md +304 -0
  19. package/assets/themes/clay/SUMMARY.md +7 -0
  20. package/assets/themes/clickhouse/DESIGN.md +281 -0
  21. package/assets/themes/clickhouse/SUMMARY.md +7 -0
  22. package/assets/themes/cohere/DESIGN.md +266 -0
  23. package/assets/themes/cohere/SUMMARY.md +7 -0
  24. package/assets/themes/coinbase/DESIGN.md +129 -0
  25. package/assets/themes/coinbase/SUMMARY.md +7 -0
  26. package/assets/themes/composio/DESIGN.md +307 -0
  27. package/assets/themes/composio/SUMMARY.md +7 -0
  28. package/assets/themes/cursor/DESIGN.md +309 -0
  29. package/assets/themes/cursor/SUMMARY.md +7 -0
  30. package/assets/themes/elevenlabs/DESIGN.md +265 -0
  31. package/assets/themes/elevenlabs/SUMMARY.md +7 -0
  32. package/assets/themes/expo/DESIGN.md +281 -0
  33. package/assets/themes/expo/SUMMARY.md +7 -0
  34. package/assets/themes/ferrari/DESIGN.md +314 -0
  35. package/assets/themes/ferrari/SUMMARY.md +7 -0
  36. package/assets/themes/framer/DESIGN.md +246 -0
  37. package/assets/themes/framer/SUMMARY.md +7 -0
  38. package/assets/themes/hashicorp/DESIGN.md +278 -0
  39. package/assets/themes/hashicorp/SUMMARY.md +7 -0
  40. package/assets/themes/ibm/DESIGN.md +332 -0
  41. package/assets/themes/ibm/SUMMARY.md +7 -0
  42. package/assets/themes/intercom/DESIGN.md +146 -0
  43. package/assets/themes/intercom/SUMMARY.md +7 -0
  44. package/assets/themes/kraken/DESIGN.md +125 -0
  45. package/assets/themes/kraken/SUMMARY.md +7 -0
  46. package/assets/themes/lamborghini/DESIGN.md +288 -0
  47. package/assets/themes/lamborghini/SUMMARY.md +7 -0
  48. package/assets/themes/linear.app/DESIGN.md +367 -0
  49. package/assets/themes/linear.app/SUMMARY.md +7 -0
  50. package/assets/themes/lovable/DESIGN.md +298 -0
  51. package/assets/themes/lovable/SUMMARY.md +7 -0
  52. package/assets/themes/meta/DESIGN.md +366 -0
  53. package/assets/themes/meta/SUMMARY.md +7 -0
  54. package/assets/themes/minimax/DESIGN.md +257 -0
  55. package/assets/themes/minimax/SUMMARY.md +7 -0
  56. package/assets/themes/mintlify/DESIGN.md +326 -0
  57. package/assets/themes/mintlify/SUMMARY.md +7 -0
  58. package/assets/themes/miro/DESIGN.md +108 -0
  59. package/assets/themes/miro/SUMMARY.md +7 -0
  60. package/assets/themes/mistral.ai/DESIGN.md +261 -0
  61. package/assets/themes/mistral.ai/SUMMARY.md +7 -0
  62. package/assets/themes/mongodb/DESIGN.md +266 -0
  63. package/assets/themes/mongodb/SUMMARY.md +7 -0
  64. package/assets/themes/nike/DESIGN.md +363 -0
  65. package/assets/themes/nike/SUMMARY.md +7 -0
  66. package/assets/themes/notion/DESIGN.md +309 -0
  67. package/assets/themes/notion/SUMMARY.md +7 -0
  68. package/assets/themes/nvidia/DESIGN.md +293 -0
  69. package/assets/themes/nvidia/SUMMARY.md +7 -0
  70. package/assets/themes/ollama/DESIGN.md +267 -0
  71. package/assets/themes/ollama/SUMMARY.md +7 -0
  72. package/assets/themes/opencode.ai/DESIGN.md +281 -0
  73. package/assets/themes/opencode.ai/SUMMARY.md +7 -0
  74. package/assets/themes/pinterest/DESIGN.md +230 -0
  75. package/assets/themes/pinterest/SUMMARY.md +7 -0
  76. package/assets/themes/playstation/DESIGN.md +364 -0
  77. package/assets/themes/playstation/SUMMARY.md +7 -0
  78. package/assets/themes/posthog/DESIGN.md +256 -0
  79. package/assets/themes/posthog/SUMMARY.md +7 -0
  80. package/assets/themes/raycast/DESIGN.md +268 -0
  81. package/assets/themes/raycast/SUMMARY.md +7 -0
  82. package/assets/themes/renault/DESIGN.md +311 -0
  83. package/assets/themes/renault/SUMMARY.md +7 -0
  84. package/assets/themes/replicate/DESIGN.md +261 -0
  85. package/assets/themes/replicate/SUMMARY.md +7 -0
  86. package/assets/themes/resend/DESIGN.md +303 -0
  87. package/assets/themes/resend/SUMMARY.md +7 -0
  88. package/assets/themes/revolut/DESIGN.md +185 -0
  89. package/assets/themes/revolut/SUMMARY.md +7 -0
  90. package/assets/themes/runwayml/DESIGN.md +244 -0
  91. package/assets/themes/runwayml/SUMMARY.md +7 -0
  92. package/assets/themes/sanity/DESIGN.md +357 -0
  93. package/assets/themes/sanity/SUMMARY.md +7 -0
  94. package/assets/themes/sentry/DESIGN.md +262 -0
  95. package/assets/themes/sentry/SUMMARY.md +7 -0
  96. package/assets/themes/shopify/DESIGN.md +350 -0
  97. package/assets/themes/shopify/SUMMARY.md +7 -0
  98. package/assets/themes/spacex/DESIGN.md +194 -0
  99. package/assets/themes/spacex/SUMMARY.md +7 -0
  100. package/assets/themes/spotify/DESIGN.md +246 -0
  101. package/assets/themes/spotify/SUMMARY.md +7 -0
  102. package/assets/themes/stripe/DESIGN.md +322 -0
  103. package/assets/themes/stripe/SUMMARY.md +7 -0
  104. package/assets/themes/supabase/DESIGN.md +255 -0
  105. package/assets/themes/supabase/SUMMARY.md +7 -0
  106. package/assets/themes/superhuman/DESIGN.md +252 -0
  107. package/assets/themes/superhuman/SUMMARY.md +7 -0
  108. package/assets/themes/tesla/DESIGN.md +286 -0
  109. package/assets/themes/tesla/SUMMARY.md +7 -0
  110. package/assets/themes/theverge/DESIGN.md +339 -0
  111. package/assets/themes/theverge/SUMMARY.md +7 -0
  112. package/assets/themes/together.ai/DESIGN.md +263 -0
  113. package/assets/themes/together.ai/SUMMARY.md +7 -0
  114. package/assets/themes/uber/DESIGN.md +295 -0
  115. package/assets/themes/uber/SUMMARY.md +7 -0
  116. package/assets/themes/vercel/DESIGN.md +310 -0
  117. package/assets/themes/vercel/SUMMARY.md +7 -0
  118. package/assets/themes/voltagent/DESIGN.md +323 -0
  119. package/assets/themes/voltagent/SUMMARY.md +7 -0
  120. package/assets/themes/warp/DESIGN.md +253 -0
  121. package/assets/themes/warp/SUMMARY.md +7 -0
  122. package/assets/themes/webflow/DESIGN.md +92 -0
  123. package/assets/themes/webflow/SUMMARY.md +7 -0
  124. package/assets/themes/wired/DESIGN.md +278 -0
  125. package/assets/themes/wired/SUMMARY.md +7 -0
  126. package/assets/themes/wise/DESIGN.md +173 -0
  127. package/assets/themes/wise/SUMMARY.md +7 -0
  128. package/assets/themes/x.ai/DESIGN.md +257 -0
  129. package/assets/themes/x.ai/SUMMARY.md +7 -0
  130. package/assets/themes/zapier/DESIGN.md +328 -0
  131. package/assets/themes/zapier/SUMMARY.md +7 -0
  132. package/dist/cli.js +55 -2
  133. package/dist/cli.js.map +1 -1
  134. package/dist/commands/analyze.d.ts +1 -1
  135. package/dist/commands/analyze.js +3 -3
  136. package/dist/commands/analyze.js.map +1 -1
  137. package/dist/commands/init.d.ts.map +1 -1
  138. package/dist/commands/init.js +7 -3
  139. package/dist/commands/init.js.map +1 -1
  140. package/dist/commands/prototype.d.ts +26 -0
  141. package/dist/commands/prototype.d.ts.map +1 -0
  142. package/dist/commands/prototype.js +150 -0
  143. package/dist/commands/prototype.js.map +1 -0
  144. package/dist/commands/sync-cursor.d.ts +1 -1
  145. package/dist/commands/sync-cursor.js +2 -2
  146. package/dist/commands/sync-cursor.js.map +1 -1
  147. package/dist/commands/validate.d.ts.map +1 -1
  148. package/dist/commands/validate.js +1 -1
  149. package/dist/commands/validate.js.map +1 -1
  150. package/dist/config/load.d.ts +3 -0
  151. package/dist/config/load.d.ts.map +1 -1
  152. package/dist/config/load.js +7 -0
  153. package/dist/config/load.js.map +1 -1
  154. package/dist/graph/doc-extract.d.ts.map +1 -1
  155. package/dist/graph/doc-extract.js +115 -102
  156. package/dist/graph/doc-extract.js.map +1 -1
  157. package/dist/markdown/parse.d.ts +25 -0
  158. package/dist/markdown/parse.d.ts.map +1 -0
  159. package/dist/markdown/parse.js +100 -0
  160. package/dist/markdown/parse.js.map +1 -0
  161. package/dist/prototype/build-manifest.d.ts +18 -0
  162. package/dist/prototype/build-manifest.d.ts.map +1 -0
  163. package/dist/prototype/build-manifest.js +79 -0
  164. package/dist/prototype/build-manifest.js.map +1 -0
  165. package/dist/prototype/config.d.ts +9 -0
  166. package/dist/prototype/config.d.ts.map +1 -0
  167. package/dist/prototype/config.js +64 -0
  168. package/dist/prototype/config.js.map +1 -0
  169. package/dist/prototype/parse-screen-index.d.ts +10 -0
  170. package/dist/prototype/parse-screen-index.d.ts.map +1 -0
  171. package/dist/prototype/parse-screen-index.js +96 -0
  172. package/dist/prototype/parse-screen-index.js.map +1 -0
  173. package/dist/prototype/themes.d.ts +6 -0
  174. package/dist/prototype/themes.d.ts.map +1 -0
  175. package/dist/prototype/themes.js +55 -0
  176. package/dist/prototype/themes.js.map +1 -0
  177. package/dist/prototype/types.d.ts +49 -0
  178. package/dist/prototype/types.d.ts.map +1 -0
  179. package/dist/prototype/types.js +2 -0
  180. package/dist/prototype/types.js.map +1 -0
  181. package/dist/prototype/validate.d.ts +16 -0
  182. package/dist/prototype/validate.d.ts.map +1 -0
  183. package/dist/prototype/validate.js +82 -0
  184. package/dist/prototype/validate.js.map +1 -0
  185. package/dist/types.d.ts +1 -1
  186. package/dist/types.d.ts.map +1 -1
  187. package/dist/visualize/html.d.ts.map +1 -1
  188. package/dist/visualize/html.js +492 -282
  189. package/dist/visualize/html.js.map +1 -1
  190. package/package.json +8 -2
  191. package/scaffold/.ai-spector/.docflow/config/prototype.config.json +9 -0
  192. package/scaffold/cursor/WORKFLOW.md +63 -0
  193. package/scaffold/cursor/commands/_cli-failures.md +3 -149
  194. package/scaffold/cursor/commands/_workflow.md +9 -8
  195. package/scaffold/cursor/mcp.json +1 -15
  196. package/scaffold/cursor/skills/README.md +34 -0
  197. package/scaffold/cursor/skills/_skill-router.md +33 -14
  198. package/scaffold/cursor/skills/ai-spector/SKILL.md +31 -30
  199. package/scaffold/cursor/skills/ai-spector/references/cli-failures.md +185 -0
  200. package/scaffold/cursor/skills/ai-spector/references/generate-graph.md +130 -0
  201. package/scaffold/cursor/skills/ai-spector/references/generate-workflow.md +120 -0
  202. package/scaffold/cursor/{commands/_graph.md → skills/ai-spector/references/graph.md} +3 -4
  203. package/scaffold/cursor/{commands/_prerequisites.md → skills/ai-spector/references/prerequisites.md} +3 -3
  204. package/scaffold/cursor/skills/ai-spector/references/project-conventions.md +27 -0
  205. package/scaffold/cursor/skills/ai-spector-generate/SKILL.md +13 -33
  206. package/scaffold/cursor/skills/ai-spector-generate-basic-design/SKILL.md +33 -0
  207. package/scaffold/cursor/skills/ai-spector-generate-basic-design/references/runbook.md +83 -0
  208. package/scaffold/cursor/skills/ai-spector-generate-detail-design/SKILL.md +32 -0
  209. package/scaffold/cursor/skills/ai-spector-generate-detail-design/references/runbook.md +60 -0
  210. package/scaffold/cursor/skills/ai-spector-generate-prototype/SKILL.md +34 -0
  211. package/scaffold/cursor/skills/ai-spector-generate-prototype/references/runbook.md +113 -0
  212. package/scaffold/cursor/skills/ai-spector-generate-srs/SKILL.md +35 -0
  213. package/scaffold/cursor/skills/ai-spector-generate-srs/references/runbook.md +69 -0
  214. package/scaffold/cursor/skills/ai-spector-graph/SKILL.md +33 -26
  215. package/scaffold/cursor/skills/ai-spector-graph/references/analyze.md +86 -0
  216. package/scaffold/cursor/skills/ai-spector-graph/references/graph-commands.md +15 -0
  217. package/scaffold/cursor/{commands → skills/ai-spector-graph/references}/impact.md +3 -3
  218. package/scaffold/cursor/{commands → skills/ai-spector-graph/references}/index.md +7 -15
  219. package/scaffold/cursor/{commands → skills/ai-spector-graph/references}/link-graph.md +2 -2
  220. package/scaffold/cursor/{commands → skills/ai-spector-graph/references}/summary.md +1 -1
  221. package/scaffold/cursor/{commands → skills/ai-spector-graph/references}/sync-graph.md +2 -2
  222. package/scaffold/cursor/{commands → skills/ai-spector-graph/references}/validate-graph.md +3 -3
  223. package/scaffold/cursor/{commands → skills/ai-spector-graph/references}/visualize-graph.md +2 -2
  224. package/scaffold/cursor/skills/ai-spector-resolve-comments/SKILL.md +18 -29
  225. package/scaffold/cursor/{commands/resolve-comments.md → skills/ai-spector-resolve-comments/references/runbook.md} +2 -2
  226. package/scaffold/docs/data-source/README.md +2 -2
  227. package/scaffold/prototype/CLAUDE.md +7 -0
  228. package/scaffold/prototype/README.md +34 -0
  229. package/scaffold/prototype/manifest.json +6 -0
  230. package/scaffold/prototype/screen-map.json +6 -0
  231. package/scaffold/prototype/src/.gitkeep +0 -0
  232. package/scaffold/cursor/commands/_generate-graph.md +0 -150
  233. package/scaffold/cursor/commands/analyze.md +0 -112
  234. package/scaffold/cursor/commands/generate-basic-design.md +0 -165
  235. package/scaffold/cursor/commands/generate-detail-design.md +0 -19
  236. package/scaffold/cursor/commands/generate-srs.md +0 -183
  237. package/scaffold/cursor/commands/graph-impact.md +0 -5
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # AI Spector
2
2
 
3
- Documentation workflow in **Cursor**: traceability graph, SRS / basic / detail design, driven by slash commands. The agent runs `ai-spector` CLI you usually do not.
3
+ Documentation workflow in **Cursor**: traceability graph, SRS / basic / detail design. **Describe what you need in chat** — skills route the agent, which runs `ai-spector` CLI. You usually do not run CLI yourself.
4
4
 
5
5
  **Needs:** Node 20+, [Cursor](https://cursor.com), [uv](https://docs.astral.sh/uv/) (Graphify MCP after `init`).
6
6
 
@@ -11,48 +11,59 @@ npm install -D ai-spector
11
11
  npx ai-spector init
12
12
  ```
13
13
 
14
- 1. Open the project in Cursor → reload **MCP** → enable **ai-spector** skills (`.cursor/skills/_skill-router.md`).
14
+ 1. Open the project in Cursor → reload **MCP** → enable **all** skills under `.cursor/skills/` (see `README.md` there).
15
15
  2. Put source material in `docs/data-source/`.
16
16
 
17
17
  Re-init scaffold: `npx ai-spector init --force`. After upgrading the package: `npx ai-spector sync-cursor`.
18
18
 
19
19
  ## Workflow
20
20
 
21
- Use **slash commands** in chat (or natural language with skills on). Details: `.cursor/commands/_workflow.md`.
21
+ See `.cursor/WORKFLOW.md` after `init`. Enable all skills under `.cursor/skills/`.
22
22
 
23
- ### First run
23
+ ### First run (natural language)
24
24
 
25
25
  ```text
26
- /analyze semantic extract (+ Graphify sidecar) → graph
27
- /validate-graph → check graph
28
- /generate-srs → SRS from graph
29
- /index → sync graph after generate
26
+ analyze the data source”
27
+ validate the graph
28
+ generate the SRS
29
+ “refresh the index”
30
30
  ```
31
31
 
32
- Then: `/generate-basic-design``/generate-detail-design` as needed.
32
+ Then: generate basic designgenerate detail design as needed.
33
+
34
+ HTML prototype:
35
+
36
+ ```bash
37
+ npx ai-spector prototype themes
38
+ npx ai-spector prototype setup --theme vercel
39
+ ```
40
+
41
+ Then ask: “generate HTML prototype for all screens” → `npx ai-spector prototype manifest` → `prototype validate --strict`.
33
42
 
34
43
  ### Day to day
35
44
 
36
- | When | Command |
37
- |------|---------|
38
- | New or changed data source | `/analyze` |
39
- | Check graph | `/validate-graph` |
40
- | Regenerate docs | `/generate-srs`, `/generate-basic-design`, `/generate-detail-design` |
41
- | Edited docs or finished generate | `/index` |
42
- | What to redo after a change | `/impact` |
43
- | Review comments | `/resolve-comments` |
44
- | Explore graph | `/visualize-graph` |
45
+ | When | Say (examples) |
46
+ |------|----------------|
47
+ | New or changed data source | analyze data source” |
48
+ | Check graph | validate the graph |
49
+ | Regenerate docs | generate SRS”, “generate basic design”, |
50
+ | HTML prototype | generate prototype with stripe theme” |
51
+ | After doc edits | “re-index the graph” |
52
+ | What to redo | “what’s the impact of my changes” |
53
+ | Review comments | “resolve comments” |
54
+ | Explore graph | “visualize the graph” |
45
55
 
46
56
  ### Typical path
47
57
 
48
58
  ```text
49
- docs/data-source/ → /analyze → /validate-graph → /generate-srs/index
50
- /generate-basic-design → /generate-detail-design
59
+ docs/data-source/ → analyze → validate graph → generate SRS → index
60
+ → generate basic design → generate detail design
61
+ → prototype setup → generate HTML screens
51
62
  ```
52
63
 
53
64
  ## CLI (optional)
54
65
 
55
- For scripts or debugging: `npx ai-spector index`, `graph validate`, `graph visualize --open`, `graph impact --git`. See `npx ai-spector --help`.
66
+ For scripts or debugging: `npx ai-spector index`, `graph validate`, `graph visualize --open`, `graph impact --git`, `prototype themes|setup|manifest|validate`. See `npx ai-spector --help`.
56
67
 
57
68
  ## If something breaks
58
69
 
@@ -0,0 +1,246 @@
1
+ # Design System Inspired by Airbnb
2
+
3
+ ## 1. Visual Theme & Atmosphere
4
+
5
+ Airbnb's website is a warm, photography-forward marketplace that feels like flipping through a travel magazine where every page invites you to book. The design operates on a foundation of pure white (`#ffffff`) with the iconic Rausch Red (`#ff385c`) — named after Airbnb's first street address — serving as the singular brand accent. The result is a clean, airy canvas where listing photography, category icons, and the red CTA button are the only sources of color.
6
+
7
+ The typography uses Airbnb Cereal VF — a custom variable font that's warm and approachable, with rounded terminals that echo the brand's "belong anywhere" philosophy. The font operates in a tight weight range: 500 (medium) for most UI, 600 (semibold) for emphasis, and 700 (bold) for primary headings. Slight negative letter-spacing (-0.18px to -0.44px) on headings creates a cozy, intimate reading experience rather than the compressed efficiency of tech companies.
8
+
9
+ What distinguishes Airbnb is its palette-based token system (`--palette-*`) and multi-layered shadow approach. The primary card shadow uses a three-layer stack (`rgba(0,0,0,0.02) 0px 0px 0px 1px, rgba(0,0,0,0.04) 0px 2px 6px, rgba(0,0,0,0.1) 0px 4px 8px`) that creates a subtle, warm lift. Combined with generous border-radius (8px–32px), circular navigation controls (50%), and a category pill bar with horizontal scrolling, the interface feels tactile and inviting — designed for browsing, not commanding.
10
+
11
+ **Key Characteristics:**
12
+ - Pure white canvas with Rausch Red (`#ff385c`) as singular brand accent
13
+ - Airbnb Cereal VF — custom variable font with warm, rounded terminals
14
+ - Palette-based token system (`--palette-*`) for systematic color management
15
+ - Three-layer card shadows: border ring + soft blur + stronger blur
16
+ - Generous border-radius: 8px buttons, 14px badges, 20px cards, 32px large elements
17
+ - Circular navigation controls (50% radius)
18
+ - Photography-first listing cards — images are the hero content
19
+ - Near-black text (`#222222`) — warm, not cold
20
+ - Luxe Purple (`#460479`) and Plus Magenta (`#92174d`) for premium tiers
21
+
22
+ ## 2. Color Palette & Roles
23
+
24
+ ### Primary Brand
25
+ - **Rausch Red** (`#ff385c`): `--palette-bg-primary-core`, primary CTA, brand accent, active states
26
+ - **Deep Rausch** (`#e00b41`): `--palette-bg-tertiary-core`, pressed/dark variant of brand red
27
+ - **Error Red** (`#c13515`): `--palette-text-primary-error`, error text on light
28
+ - **Error Dark** (`#b32505`): `--palette-text-secondary-error-hover`, error hover
29
+
30
+ ### Premium Tiers
31
+ - **Luxe Purple** (`#460479`): `--palette-bg-primary-luxe`, Airbnb Luxe tier branding
32
+ - **Plus Magenta** (`#92174d`): `--palette-bg-primary-plus`, Airbnb Plus tier branding
33
+
34
+ ### Text Scale
35
+ - **Near Black** (`#222222`): `--palette-text-primary`, primary text — warm, not cold
36
+ - **Focused Gray** (`#3f3f3f`): `--palette-text-focused`, focused state text
37
+ - **Secondary Gray** (`#6a6a6a`): Secondary text, descriptions
38
+ - **Disabled** (`rgba(0,0,0,0.24)`): `--palette-text-material-disabled`, disabled state
39
+ - **Link Disabled** (`#929292`): `--palette-text-link-disabled`, disabled links
40
+
41
+ ### Interactive
42
+ - **Legal Blue** (`#428bff`): `--palette-text-legal`, legal links, informational
43
+ - **Border Gray** (`#c1c1c1`): Border color for cards and dividers
44
+ - **Light Surface** (`#f2f2f2`): Circular navigation buttons, secondary surfaces
45
+
46
+ ### Surface & Shadows
47
+ - **Pure White** (`#ffffff`): Page background, card surfaces
48
+ - **Card Shadow** (`rgba(0,0,0,0.02) 0px 0px 0px 1px, rgba(0,0,0,0.04) 0px 2px 6px, rgba(0,0,0,0.1) 0px 4px 8px`): Three-layer warm lift
49
+ - **Hover Shadow** (`rgba(0,0,0,0.08) 0px 4px 12px`): Button hover elevation
50
+
51
+ ## 3. Typography Rules
52
+
53
+ ### Font Family
54
+ - **Primary**: `Airbnb Cereal VF`, fallbacks: `Circular, -apple-system, system-ui, Roboto, Helvetica Neue`
55
+ - **OpenType Features**: `"salt"` (stylistic alternates) on specific caption elements
56
+
57
+ ### Hierarchy
58
+
59
+ | Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
60
+ |------|------|------|--------|-------------|----------------|-------|
61
+ | Section Heading | Airbnb Cereal VF | 28px (1.75rem) | 700 | 1.43 | normal | Primary headings |
62
+ | Card Heading | Airbnb Cereal VF | 22px (1.38rem) | 600 | 1.18 (tight) | -0.44px | Category/card titles |
63
+ | Card Heading Medium | Airbnb Cereal VF | 22px (1.38rem) | 500 | 1.18 (tight) | -0.44px | Lighter variant |
64
+ | Sub-heading | Airbnb Cereal VF | 21px (1.31rem) | 700 | 1.43 | normal | Bold sub-headings |
65
+ | Feature Title | Airbnb Cereal VF | 20px (1.25rem) | 600 | 1.20 (tight) | -0.18px | Feature headings |
66
+ | UI Medium | Airbnb Cereal VF | 16px (1.00rem) | 500 | 1.25 (tight) | normal | Nav, emphasized text |
67
+ | UI Semibold | Airbnb Cereal VF | 16px (1.00rem) | 600 | 1.25 (tight) | normal | Strong emphasis |
68
+ | Button | Airbnb Cereal VF | 16px (1.00rem) | 500 | 1.25 (tight) | normal | Button labels |
69
+ | Body / Link | Airbnb Cereal VF | 14px (0.88rem) | 400 | 1.43 | normal | Standard body |
70
+ | Body Medium | Airbnb Cereal VF | 14px (0.88rem) | 500 | 1.29 (tight) | normal | Medium body |
71
+ | Caption Salt | Airbnb Cereal VF | 14px (0.88rem) | 600 | 1.43 | normal | `"salt"` feature |
72
+ | Small | Airbnb Cereal VF | 13px (0.81rem) | 400 | 1.23 (tight) | normal | Descriptions |
73
+ | Tag | Airbnb Cereal VF | 12px (0.75rem) | 400–700 | 1.33 | normal | Tags, prices |
74
+ | Badge | Airbnb Cereal VF | 11px (0.69rem) | 600 | 1.18 (tight) | normal | `"salt"` feature |
75
+ | Micro Uppercase | Airbnb Cereal VF | 8px (0.50rem) | 700 | 1.25 (tight) | 0.32px | `text-transform: uppercase` |
76
+
77
+ ### Principles
78
+ - **Warm weight range**: 500–700 dominate. No weight 300 or 400 for headings — Airbnb's type is always at least medium weight, creating a warm, confident voice.
79
+ - **Negative tracking on headings**: -0.18px to -0.44px letter-spacing on display creates intimate, cozy headings rather than cold, compressed ones.
80
+ - **"salt" OpenType feature**: Stylistic alternates on specific UI elements (badges, captions) create subtle glyph variations that add visual interest.
81
+ - **Variable font precision**: Cereal VF enables continuous weight interpolation, though the design system uses discrete stops at 500, 600, and 700.
82
+
83
+ ## 4. Component Stylings
84
+
85
+ ### Buttons
86
+
87
+ **Primary Dark**
88
+ - Background: `#222222` (near-black, not pure black)
89
+ - Text: `#ffffff`
90
+ - Padding: 0px 24px
91
+ - Radius: 8px
92
+ - Hover: transitions to error/brand accent via `var(--accent-bg-error)`
93
+ - Focus: `0 0 0 2px var(--palette-grey1000)` ring + scale(0.92)
94
+
95
+ **Circular Nav**
96
+ - Background: `#f2f2f2`
97
+ - Text: `#222222`
98
+ - Radius: 50% (circle)
99
+ - Hover: shadow `rgba(0,0,0,0.08) 0px 4px 12px` + translateX(50%)
100
+ - Active: 4px white border ring + focus shadow
101
+ - Focus: scale(0.92) shrink animation
102
+
103
+ ### Cards & Containers
104
+ - Background: `#ffffff`
105
+ - Radius: 14px (badges), 20px (cards/buttons), 32px (large)
106
+ - Shadow: `rgba(0,0,0,0.02) 0px 0px 0px 1px, rgba(0,0,0,0.04) 0px 2px 6px, rgba(0,0,0,0.1) 0px 4px 8px` (three-layer)
107
+ - Listing cards: full-width photography on top, details below
108
+ - Carousel controls: circular 50% buttons
109
+
110
+ ### Inputs
111
+ - Search: `#222222` text
112
+ - Focus: `var(--palette-bg-primary-error)` background tint + `0 0 0 2px` ring
113
+ - Radius: depends on context (search bar uses pill-like rounding)
114
+
115
+ ### Navigation
116
+ - White sticky header with search bar centered
117
+ - Airbnb logo (Rausch Red) left-aligned
118
+ - Category filter pills: horizontal scroll below search
119
+ - Circular nav controls for carousel navigation
120
+ - "Become a Host" text link, avatar/menu right-aligned
121
+
122
+ ### Image Treatment
123
+ - Listing photography fills card top with generous height
124
+ - Image carousel with dot indicators
125
+ - Heart/wishlist icon overlay on images
126
+ - 8px–14px radius on contained images
127
+
128
+ ## 5. Layout Principles
129
+
130
+ ### Spacing System
131
+ - Base unit: 8px
132
+ - Scale: 2px, 3px, 4px, 6px, 8px, 10px, 11px, 12px, 15px, 16px, 22px, 24px, 32px
133
+
134
+ ### Grid & Container
135
+ - Full-width header with centered search
136
+ - Category pill bar: horizontal scrollable row
137
+ - Listing grid: responsive multi-column (3–5 columns on desktop)
138
+ - Full-width footer with link columns
139
+
140
+ ### Whitespace Philosophy
141
+ - **Travel-magazine spacing**: Generous vertical padding between sections creates a leisurely browsing pace — you're meant to scroll slowly, like browsing a magazine.
142
+ - **Photography density**: Listing cards are packed relatively tightly, but each image is large enough to feel immersive.
143
+ - **Search bar prominence**: The search bar gets maximum vertical space in the header — finding your destination is the primary action.
144
+
145
+ ### Border Radius Scale
146
+ - Subtle (4px): Small links
147
+ - Standard (8px): Buttons, tabs, search elements
148
+ - Badge (14px): Status badges, labels
149
+ - Card (20px): Feature cards, large buttons
150
+ - Large (32px): Large containers, hero elements
151
+ - Circle (50%): Nav controls, avatars, icons
152
+
153
+ ## 6. Depth & Elevation
154
+
155
+ | Level | Treatment | Use |
156
+ |-------|-----------|-----|
157
+ | Flat (Level 0) | No shadow | Page background, text blocks |
158
+ | Card (Level 1) | `rgba(0,0,0,0.02) 0px 0px 0px 1px, rgba(0,0,0,0.04) 0px 2px 6px, rgba(0,0,0,0.1) 0px 4px 8px` | Listing cards, search bar |
159
+ | Hover (Level 2) | `rgba(0,0,0,0.08) 0px 4px 12px` | Button hover, interactive lift |
160
+ | Active Focus (Level 3) | `rgb(255,255,255) 0px 0px 0px 4px` + focus ring | Active/focused elements |
161
+
162
+ **Shadow Philosophy**: Airbnb's three-layer shadow system creates a warm, natural lift. Layer 1 (`0px 0px 0px 1px` at 0.02 opacity) is an ultra-subtle border. Layer 2 (`0px 2px 6px` at 0.04) provides soft ambient shadow. Layer 3 (`0px 4px 8px` at 0.1) adds the primary lift. This graduated approach creates shadows that feel like natural light rather than CSS effects.
163
+
164
+ ## 7. Do's and Don'ts
165
+
166
+ ### Do
167
+ - Use `#222222` (warm near-black) for text — never pure `#000000`
168
+ - Apply Rausch Red (`#ff385c`) only for primary CTAs and brand moments — it's the singular accent
169
+ - Use Airbnb Cereal VF at weight 500–700 — the warm weight range is intentional
170
+ - Apply the three-layer card shadow for all elevated surfaces
171
+ - Use generous border-radius: 8px for buttons, 20px for cards, 50% for controls
172
+ - Use photography as the primary visual content — listings are image-first
173
+ - Apply negative letter-spacing (-0.18px to -0.44px) on headings for intimacy
174
+ - Use circular (50%) buttons for carousel/navigation controls
175
+
176
+ ### Don't
177
+ - Don't use pure black (`#000000`) for text — always `#222222` (warm)
178
+ - Don't apply Rausch Red to backgrounds or large surfaces — it's an accent only
179
+ - Don't use thin font weights (300, 400) for headings — 500 minimum
180
+ - Don't use heavy shadows (>0.1 opacity as primary layer) — keep them warm and graduated
181
+ - Don't use sharp corners (0–4px) on cards — the generous rounding (20px+) is core
182
+ - Don't introduce additional brand colors beyond the Rausch/Luxe/Plus system
183
+ - Don't override the palette token system — use `--palette-*` variables consistently
184
+
185
+ ## 8. Responsive Behavior
186
+
187
+ ### Breakpoints
188
+ | Name | Width | Key Changes |
189
+ |------|-------|-------------|
190
+ | Mobile Small | <375px | Single column, compact search |
191
+ | Mobile | 375–550px | Standard mobile listing grid |
192
+ | Tablet Small | 550–744px | 2-column listings |
193
+ | Tablet | 744–950px | Search bar expansion |
194
+ | Desktop Small | 950–1128px | 3-column listings |
195
+ | Desktop | 1128–1440px | 4-column grid, full header |
196
+ | Large Desktop | 1440–1920px | 5-column grid |
197
+ | Ultra-wide | >1920px | Maximum grid width |
198
+
199
+ *Note: Airbnb has 61 detected breakpoints — one of the most granular responsive systems observed, reflecting their obsession with layout at every possible screen size.*
200
+
201
+ ### Touch Targets
202
+ - Circular nav buttons: adequate 50% radius sizing
203
+ - Listing cards: full-card tap target on mobile
204
+ - Search bar: prominently sized for thumb interaction
205
+ - Category pills: horizontally scrollable with generous padding
206
+
207
+ ### Collapsing Strategy
208
+ - Listing grid: 5 → 4 → 3 → 2 → 1 columns
209
+ - Search: expanded bar → compact bar → overlay
210
+ - Category pills: horizontal scroll at all sizes
211
+ - Navigation: full header → mobile simplified
212
+ - Map: side panel → overlay/toggle
213
+
214
+ ### Image Behavior
215
+ - Listing photos: carousel with swipe on mobile
216
+ - Responsive image sizing with aspect ratio maintained
217
+ - Heart overlay positioned consistently across sizes
218
+ - Photo quality adjusts based on viewport
219
+
220
+ ## 9. Agent Prompt Guide
221
+
222
+ ### Quick Color Reference
223
+ - Background: Pure White (`#ffffff`)
224
+ - Text: Near Black (`#222222`)
225
+ - Brand accent: Rausch Red (`#ff385c`)
226
+ - Secondary text: `#6a6a6a`
227
+ - Disabled: `rgba(0,0,0,0.24)`
228
+ - Card border: `rgba(0,0,0,0.02) 0px 0px 0px 1px`
229
+ - Card shadow: full three-layer stack
230
+ - Button surface: `#f2f2f2`
231
+
232
+ ### Example Component Prompts
233
+ - "Create a listing card: white background, 20px radius. Three-layer shadow: rgba(0,0,0,0.02) 0px 0px 0px 1px, rgba(0,0,0,0.04) 0px 2px 6px, rgba(0,0,0,0.1) 0px 4px 8px. Photo area on top (16:10 ratio), details below: 16px Airbnb Cereal VF weight 600 title, 14px weight 400 description in #6a6a6a."
234
+ - "Design search bar: white background, full card shadow, 32px radius on container. Search text at 14px Cereal VF weight 400. Red search button (#ff385c, 50% radius, white icon)."
235
+ - "Build category pill bar: horizontal scrollable row. Each pill: 14px Cereal VF weight 600, #222222 text, bottom border on active. Circular prev/next arrows (#f2f2f2 bg, 50% radius)."
236
+ - "Create a CTA button: #222222 background, white text, 8px radius, 16px Cereal VF weight 500, 0px 24px padding. Hover: brand red accent."
237
+ - "Design a heart/wishlist button: transparent background, 50% radius, white heart icon with dark shadow outline."
238
+
239
+ ### Iteration Guide
240
+ 1. Start with white — the photography provides all the color
241
+ 2. Rausch Red (#ff385c) is the singular accent — use sparingly for CTAs only
242
+ 3. Near-black (#222222) for text — the warmth matters
243
+ 4. Three-layer shadows create natural, warm lift — always use all three layers
244
+ 5. Generous radius: 8px buttons, 20px cards, 50% controls
245
+ 6. Cereal VF at 500–700 weight — no thin weights for any heading
246
+ 7. Photography is hero — every listing card is image-first
@@ -0,0 +1,7 @@
1
+ Visual vibe — Warm, human-centric light UI with soft rounded surfaces and photography-led storytelling.
2
+
3
+ Atmosphere — Feels like a trusted travel marketplace: airy layouts, friendly typography, and emphasis on hosts, places, and emotional connection rather than dense dashboards.
4
+
5
+ Signature — Rounded cards · soft neutrals with coral/rose accents · large lifestyle imagery · clear booking-style CTAs · approachable microcopy tone.
6
+
7
+ Suggest for (AI) — Travel, hospitality, marketplaces, consumer booking flows, two-sided platforms, trust-and-safety messaging, lifestyle brands.
@@ -0,0 +1,89 @@
1
+ # Design System Inspired by Airtable
2
+
3
+ ## 1. Visual Theme & Atmosphere
4
+
5
+ Airtable's website is a clean, enterprise-friendly platform that communicates "sophisticated simplicity" through a white canvas with deep navy text (`#181d26`) and Airtable Blue (`#1b61c9`) as the primary interactive accent. The Haas font family (display + text variants) creates a Swiss-precision typography system with positive letter-spacing throughout.
6
+
7
+ **Key Characteristics:**
8
+ - White canvas with deep navy text (`#181d26`)
9
+ - Airtable Blue (`#1b61c9`) as primary CTA and link color
10
+ - Haas + Haas Groot Disp dual font system
11
+ - Positive letter-spacing on body text (0.08px–0.28px)
12
+ - 12px radius buttons, 16px–32px for cards
13
+ - Multi-layer blue-tinted shadow: `rgba(45,127,249,0.28) 0px 1px 3px`
14
+ - Semantic theme tokens: `--theme_*` CSS variable naming
15
+
16
+ ## 2. Color Palette & Roles
17
+
18
+ ### Primary
19
+ - **Deep Navy** (`#181d26`): Primary text
20
+ - **Airtable Blue** (`#1b61c9`): CTA buttons, links
21
+ - **White** (`#ffffff`): Primary surface
22
+ - **Spotlight** (`rgba(249,252,255,0.97)`): `--theme_button-text-spotlight`
23
+
24
+ ### Semantic
25
+ - **Success Green** (`#006400`): `--theme_success-text`
26
+ - **Weak Text** (`rgba(4,14,32,0.69)`): `--theme_text-weak`
27
+ - **Secondary Active** (`rgba(7,12,20,0.82)`): `--theme_button-text-secondary-active`
28
+
29
+ ### Neutral
30
+ - **Dark Gray** (`#333333`): Secondary text
31
+ - **Mid Blue** (`#254fad`): Link/accent blue variant
32
+ - **Border** (`#e0e2e6`): Card borders
33
+ - **Light Surface** (`#f8fafc`): Subtle surface
34
+
35
+ ### Shadows
36
+ - **Blue-tinted** (`rgba(0,0,0,0.32) 0px 0px 1px, rgba(0,0,0,0.08) 0px 0px 2px, rgba(45,127,249,0.28) 0px 1px 3px, rgba(0,0,0,0.06) 0px 0px 0px 0.5px inset`)
37
+ - **Soft** (`rgba(15,48,106,0.05) 0px 0px 20px`)
38
+
39
+ ## 3. Typography Rules
40
+
41
+ ### Font Families
42
+ - **Primary**: `Haas`, fallbacks: `-apple-system, system-ui, Segoe UI, Roboto`
43
+ - **Display**: `Haas Groot Disp`, fallback: `Haas`
44
+
45
+ ### Hierarchy
46
+
47
+ | Role | Font | Size | Weight | Line Height | Letter Spacing |
48
+ |------|------|------|--------|-------------|----------------|
49
+ | Display Hero | Haas | 48px | 400 | 1.15 | normal |
50
+ | Display Bold | Haas Groot Disp | 48px | 900 | 1.50 | normal |
51
+ | Section Heading | Haas | 40px | 400 | 1.25 | normal |
52
+ | Sub-heading | Haas | 32px | 400–500 | 1.15–1.25 | normal |
53
+ | Card Title | Haas | 24px | 400 | 1.20–1.30 | 0.12px |
54
+ | Feature | Haas | 20px | 400 | 1.25–1.50 | 0.1px |
55
+ | Body | Haas | 18px | 400 | 1.35 | 0.18px |
56
+ | Body Medium | Haas | 16px | 500 | 1.30 | 0.08–0.16px |
57
+ | Button | Haas | 16px | 500 | 1.25–1.30 | 0.08px |
58
+ | Caption | Haas | 14px | 400–500 | 1.25–1.35 | 0.07–0.28px |
59
+
60
+ ## 4. Component Stylings
61
+
62
+ ### Buttons
63
+ - **Primary Blue**: `#1b61c9`, white text, 16px 24px padding, 12px radius
64
+ - **White**: white bg, `#181d26` text, 12px radius, 1px border white
65
+ - **Cookie Consent**: `#1b61c9` bg, 2px radius (sharp)
66
+
67
+ ### Cards: `1px solid #e0e2e6`, 16px–24px radius
68
+ ### Inputs: Standard Haas styling
69
+
70
+ ## 5. Layout
71
+ - Spacing: 1–48px (8px base)
72
+ - Radius: 2px (small), 12px (buttons), 16px (cards), 24px (sections), 32px (large), 50% (circles)
73
+
74
+ ## 6. Depth
75
+ - Blue-tinted multi-layer shadow system
76
+ - Soft ambient: `rgba(15,48,106,0.05) 0px 0px 20px`
77
+
78
+ ## 7. Do's and Don'ts
79
+ ### Do: Use Airtable Blue for CTAs, Haas with positive tracking, 12px radius buttons
80
+ ### Don't: Skip positive letter-spacing, use heavy shadows
81
+
82
+ ## 8. Responsive Behavior
83
+ Breakpoints: 425–1664px (23 breakpoints)
84
+
85
+ ## 9. Agent Prompt Guide
86
+ - Text: Deep Navy (`#181d26`)
87
+ - CTA: Airtable Blue (`#1b61c9`)
88
+ - Background: White (`#ffffff`)
89
+ - Border: `#e0e2e6`
@@ -0,0 +1,7 @@
1
+ Visual vibe — Enterprise-grade but approachable: bright surfaces, strong blue accent, spreadsheet-adjacent clarity.
2
+
3
+ Atmosphere — Swiss-precision typography and structured grids evoke “smart spreadsheet / app builder” without feeling like raw Excel—good for ops teams who need power and clarity.
4
+
5
+ Signature — Navy + Airtable blue · Haas family · disciplined spacing · clear hierarchy for fields, records, and views.
6
+
7
+ Suggest for (AI) — Internal tools, ops dashboards, CRM-light, configurable workflows, teams that live in tables and linked records.