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.
- package/README.md +32 -21
- package/assets/themes/airbnb/DESIGN.md +246 -0
- package/assets/themes/airbnb/SUMMARY.md +7 -0
- package/assets/themes/airtable/DESIGN.md +89 -0
- package/assets/themes/airtable/SUMMARY.md +7 -0
- package/assets/themes/apple/DESIGN.md +313 -0
- package/assets/themes/apple/SUMMARY.md +7 -0
- package/assets/themes/binance/DESIGN.md +345 -0
- package/assets/themes/binance/SUMMARY.md +7 -0
- package/assets/themes/bmw/DESIGN.md +180 -0
- package/assets/themes/bmw/SUMMARY.md +7 -0
- package/assets/themes/bugatti/DESIGN.md +268 -0
- package/assets/themes/bugatti/SUMMARY.md +7 -0
- package/assets/themes/cal/DESIGN.md +259 -0
- package/assets/themes/cal/SUMMARY.md +7 -0
- package/assets/themes/claude/DESIGN.md +312 -0
- package/assets/themes/claude/SUMMARY.md +7 -0
- package/assets/themes/clay/DESIGN.md +304 -0
- package/assets/themes/clay/SUMMARY.md +7 -0
- package/assets/themes/clickhouse/DESIGN.md +281 -0
- package/assets/themes/clickhouse/SUMMARY.md +7 -0
- package/assets/themes/cohere/DESIGN.md +266 -0
- package/assets/themes/cohere/SUMMARY.md +7 -0
- package/assets/themes/coinbase/DESIGN.md +129 -0
- package/assets/themes/coinbase/SUMMARY.md +7 -0
- package/assets/themes/composio/DESIGN.md +307 -0
- package/assets/themes/composio/SUMMARY.md +7 -0
- package/assets/themes/cursor/DESIGN.md +309 -0
- package/assets/themes/cursor/SUMMARY.md +7 -0
- package/assets/themes/elevenlabs/DESIGN.md +265 -0
- package/assets/themes/elevenlabs/SUMMARY.md +7 -0
- package/assets/themes/expo/DESIGN.md +281 -0
- package/assets/themes/expo/SUMMARY.md +7 -0
- package/assets/themes/ferrari/DESIGN.md +314 -0
- package/assets/themes/ferrari/SUMMARY.md +7 -0
- package/assets/themes/framer/DESIGN.md +246 -0
- package/assets/themes/framer/SUMMARY.md +7 -0
- package/assets/themes/hashicorp/DESIGN.md +278 -0
- package/assets/themes/hashicorp/SUMMARY.md +7 -0
- package/assets/themes/ibm/DESIGN.md +332 -0
- package/assets/themes/ibm/SUMMARY.md +7 -0
- package/assets/themes/intercom/DESIGN.md +146 -0
- package/assets/themes/intercom/SUMMARY.md +7 -0
- package/assets/themes/kraken/DESIGN.md +125 -0
- package/assets/themes/kraken/SUMMARY.md +7 -0
- package/assets/themes/lamborghini/DESIGN.md +288 -0
- package/assets/themes/lamborghini/SUMMARY.md +7 -0
- package/assets/themes/linear.app/DESIGN.md +367 -0
- package/assets/themes/linear.app/SUMMARY.md +7 -0
- package/assets/themes/lovable/DESIGN.md +298 -0
- package/assets/themes/lovable/SUMMARY.md +7 -0
- package/assets/themes/meta/DESIGN.md +366 -0
- package/assets/themes/meta/SUMMARY.md +7 -0
- package/assets/themes/minimax/DESIGN.md +257 -0
- package/assets/themes/minimax/SUMMARY.md +7 -0
- package/assets/themes/mintlify/DESIGN.md +326 -0
- package/assets/themes/mintlify/SUMMARY.md +7 -0
- package/assets/themes/miro/DESIGN.md +108 -0
- package/assets/themes/miro/SUMMARY.md +7 -0
- package/assets/themes/mistral.ai/DESIGN.md +261 -0
- package/assets/themes/mistral.ai/SUMMARY.md +7 -0
- package/assets/themes/mongodb/DESIGN.md +266 -0
- package/assets/themes/mongodb/SUMMARY.md +7 -0
- package/assets/themes/nike/DESIGN.md +363 -0
- package/assets/themes/nike/SUMMARY.md +7 -0
- package/assets/themes/notion/DESIGN.md +309 -0
- package/assets/themes/notion/SUMMARY.md +7 -0
- package/assets/themes/nvidia/DESIGN.md +293 -0
- package/assets/themes/nvidia/SUMMARY.md +7 -0
- package/assets/themes/ollama/DESIGN.md +267 -0
- package/assets/themes/ollama/SUMMARY.md +7 -0
- package/assets/themes/opencode.ai/DESIGN.md +281 -0
- package/assets/themes/opencode.ai/SUMMARY.md +7 -0
- package/assets/themes/pinterest/DESIGN.md +230 -0
- package/assets/themes/pinterest/SUMMARY.md +7 -0
- package/assets/themes/playstation/DESIGN.md +364 -0
- package/assets/themes/playstation/SUMMARY.md +7 -0
- package/assets/themes/posthog/DESIGN.md +256 -0
- package/assets/themes/posthog/SUMMARY.md +7 -0
- package/assets/themes/raycast/DESIGN.md +268 -0
- package/assets/themes/raycast/SUMMARY.md +7 -0
- package/assets/themes/renault/DESIGN.md +311 -0
- package/assets/themes/renault/SUMMARY.md +7 -0
- package/assets/themes/replicate/DESIGN.md +261 -0
- package/assets/themes/replicate/SUMMARY.md +7 -0
- package/assets/themes/resend/DESIGN.md +303 -0
- package/assets/themes/resend/SUMMARY.md +7 -0
- package/assets/themes/revolut/DESIGN.md +185 -0
- package/assets/themes/revolut/SUMMARY.md +7 -0
- package/assets/themes/runwayml/DESIGN.md +244 -0
- package/assets/themes/runwayml/SUMMARY.md +7 -0
- package/assets/themes/sanity/DESIGN.md +357 -0
- package/assets/themes/sanity/SUMMARY.md +7 -0
- package/assets/themes/sentry/DESIGN.md +262 -0
- package/assets/themes/sentry/SUMMARY.md +7 -0
- package/assets/themes/shopify/DESIGN.md +350 -0
- package/assets/themes/shopify/SUMMARY.md +7 -0
- package/assets/themes/spacex/DESIGN.md +194 -0
- package/assets/themes/spacex/SUMMARY.md +7 -0
- package/assets/themes/spotify/DESIGN.md +246 -0
- package/assets/themes/spotify/SUMMARY.md +7 -0
- package/assets/themes/stripe/DESIGN.md +322 -0
- package/assets/themes/stripe/SUMMARY.md +7 -0
- package/assets/themes/supabase/DESIGN.md +255 -0
- package/assets/themes/supabase/SUMMARY.md +7 -0
- package/assets/themes/superhuman/DESIGN.md +252 -0
- package/assets/themes/superhuman/SUMMARY.md +7 -0
- package/assets/themes/tesla/DESIGN.md +286 -0
- package/assets/themes/tesla/SUMMARY.md +7 -0
- package/assets/themes/theverge/DESIGN.md +339 -0
- package/assets/themes/theverge/SUMMARY.md +7 -0
- package/assets/themes/together.ai/DESIGN.md +263 -0
- package/assets/themes/together.ai/SUMMARY.md +7 -0
- package/assets/themes/uber/DESIGN.md +295 -0
- package/assets/themes/uber/SUMMARY.md +7 -0
- package/assets/themes/vercel/DESIGN.md +310 -0
- package/assets/themes/vercel/SUMMARY.md +7 -0
- package/assets/themes/voltagent/DESIGN.md +323 -0
- package/assets/themes/voltagent/SUMMARY.md +7 -0
- package/assets/themes/warp/DESIGN.md +253 -0
- package/assets/themes/warp/SUMMARY.md +7 -0
- package/assets/themes/webflow/DESIGN.md +92 -0
- package/assets/themes/webflow/SUMMARY.md +7 -0
- package/assets/themes/wired/DESIGN.md +278 -0
- package/assets/themes/wired/SUMMARY.md +7 -0
- package/assets/themes/wise/DESIGN.md +173 -0
- package/assets/themes/wise/SUMMARY.md +7 -0
- package/assets/themes/x.ai/DESIGN.md +257 -0
- package/assets/themes/x.ai/SUMMARY.md +7 -0
- package/assets/themes/zapier/DESIGN.md +328 -0
- package/assets/themes/zapier/SUMMARY.md +7 -0
- package/dist/cli.js +55 -2
- package/dist/cli.js.map +1 -1
- package/dist/commands/analyze.d.ts +1 -1
- package/dist/commands/analyze.js +3 -3
- package/dist/commands/analyze.js.map +1 -1
- package/dist/commands/init.d.ts.map +1 -1
- package/dist/commands/init.js +7 -3
- package/dist/commands/init.js.map +1 -1
- package/dist/commands/prototype.d.ts +26 -0
- package/dist/commands/prototype.d.ts.map +1 -0
- package/dist/commands/prototype.js +150 -0
- package/dist/commands/prototype.js.map +1 -0
- package/dist/commands/sync-cursor.d.ts +1 -1
- package/dist/commands/sync-cursor.js +2 -2
- package/dist/commands/sync-cursor.js.map +1 -1
- package/dist/commands/validate.d.ts.map +1 -1
- package/dist/commands/validate.js +1 -1
- package/dist/commands/validate.js.map +1 -1
- package/dist/config/load.d.ts +3 -0
- package/dist/config/load.d.ts.map +1 -1
- package/dist/config/load.js +7 -0
- package/dist/config/load.js.map +1 -1
- package/dist/graph/doc-extract.d.ts.map +1 -1
- package/dist/graph/doc-extract.js +115 -102
- package/dist/graph/doc-extract.js.map +1 -1
- package/dist/markdown/parse.d.ts +25 -0
- package/dist/markdown/parse.d.ts.map +1 -0
- package/dist/markdown/parse.js +100 -0
- package/dist/markdown/parse.js.map +1 -0
- package/dist/prototype/build-manifest.d.ts +18 -0
- package/dist/prototype/build-manifest.d.ts.map +1 -0
- package/dist/prototype/build-manifest.js +79 -0
- package/dist/prototype/build-manifest.js.map +1 -0
- package/dist/prototype/config.d.ts +9 -0
- package/dist/prototype/config.d.ts.map +1 -0
- package/dist/prototype/config.js +64 -0
- package/dist/prototype/config.js.map +1 -0
- package/dist/prototype/parse-screen-index.d.ts +10 -0
- package/dist/prototype/parse-screen-index.d.ts.map +1 -0
- package/dist/prototype/parse-screen-index.js +96 -0
- package/dist/prototype/parse-screen-index.js.map +1 -0
- package/dist/prototype/themes.d.ts +6 -0
- package/dist/prototype/themes.d.ts.map +1 -0
- package/dist/prototype/themes.js +55 -0
- package/dist/prototype/themes.js.map +1 -0
- package/dist/prototype/types.d.ts +49 -0
- package/dist/prototype/types.d.ts.map +1 -0
- package/dist/prototype/types.js +2 -0
- package/dist/prototype/types.js.map +1 -0
- package/dist/prototype/validate.d.ts +16 -0
- package/dist/prototype/validate.d.ts.map +1 -0
- package/dist/prototype/validate.js +82 -0
- package/dist/prototype/validate.js.map +1 -0
- package/dist/types.d.ts +1 -1
- package/dist/types.d.ts.map +1 -1
- package/dist/visualize/html.d.ts.map +1 -1
- package/dist/visualize/html.js +492 -282
- package/dist/visualize/html.js.map +1 -1
- package/package.json +8 -2
- package/scaffold/.ai-spector/.docflow/config/prototype.config.json +9 -0
- package/scaffold/cursor/WORKFLOW.md +63 -0
- package/scaffold/cursor/commands/_cli-failures.md +3 -149
- package/scaffold/cursor/commands/_workflow.md +9 -8
- package/scaffold/cursor/mcp.json +1 -15
- package/scaffold/cursor/skills/README.md +34 -0
- package/scaffold/cursor/skills/_skill-router.md +33 -14
- package/scaffold/cursor/skills/ai-spector/SKILL.md +31 -30
- package/scaffold/cursor/skills/ai-spector/references/cli-failures.md +185 -0
- package/scaffold/cursor/skills/ai-spector/references/generate-graph.md +130 -0
- package/scaffold/cursor/skills/ai-spector/references/generate-workflow.md +120 -0
- package/scaffold/cursor/{commands/_graph.md → skills/ai-spector/references/graph.md} +3 -4
- package/scaffold/cursor/{commands/_prerequisites.md → skills/ai-spector/references/prerequisites.md} +3 -3
- package/scaffold/cursor/skills/ai-spector/references/project-conventions.md +27 -0
- package/scaffold/cursor/skills/ai-spector-generate/SKILL.md +13 -33
- package/scaffold/cursor/skills/ai-spector-generate-basic-design/SKILL.md +33 -0
- package/scaffold/cursor/skills/ai-spector-generate-basic-design/references/runbook.md +83 -0
- package/scaffold/cursor/skills/ai-spector-generate-detail-design/SKILL.md +32 -0
- package/scaffold/cursor/skills/ai-spector-generate-detail-design/references/runbook.md +60 -0
- package/scaffold/cursor/skills/ai-spector-generate-prototype/SKILL.md +34 -0
- package/scaffold/cursor/skills/ai-spector-generate-prototype/references/runbook.md +113 -0
- package/scaffold/cursor/skills/ai-spector-generate-srs/SKILL.md +35 -0
- package/scaffold/cursor/skills/ai-spector-generate-srs/references/runbook.md +69 -0
- package/scaffold/cursor/skills/ai-spector-graph/SKILL.md +33 -26
- package/scaffold/cursor/skills/ai-spector-graph/references/analyze.md +86 -0
- package/scaffold/cursor/skills/ai-spector-graph/references/graph-commands.md +15 -0
- package/scaffold/cursor/{commands → skills/ai-spector-graph/references}/impact.md +3 -3
- package/scaffold/cursor/{commands → skills/ai-spector-graph/references}/index.md +7 -15
- package/scaffold/cursor/{commands → skills/ai-spector-graph/references}/link-graph.md +2 -2
- package/scaffold/cursor/{commands → skills/ai-spector-graph/references}/summary.md +1 -1
- package/scaffold/cursor/{commands → skills/ai-spector-graph/references}/sync-graph.md +2 -2
- package/scaffold/cursor/{commands → skills/ai-spector-graph/references}/validate-graph.md +3 -3
- package/scaffold/cursor/{commands → skills/ai-spector-graph/references}/visualize-graph.md +2 -2
- package/scaffold/cursor/skills/ai-spector-resolve-comments/SKILL.md +18 -29
- package/scaffold/cursor/{commands/resolve-comments.md → skills/ai-spector-resolve-comments/references/runbook.md} +2 -2
- package/scaffold/docs/data-source/README.md +2 -2
- package/scaffold/prototype/CLAUDE.md +7 -0
- package/scaffold/prototype/README.md +34 -0
- package/scaffold/prototype/manifest.json +6 -0
- package/scaffold/prototype/screen-map.json +6 -0
- package/scaffold/prototype/src/.gitkeep +0 -0
- package/scaffold/cursor/commands/_generate-graph.md +0 -150
- package/scaffold/cursor/commands/analyze.md +0 -112
- package/scaffold/cursor/commands/generate-basic-design.md +0 -165
- package/scaffold/cursor/commands/generate-detail-design.md +0 -19
- package/scaffold/cursor/commands/generate-srs.md +0 -183
- 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
|
|
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 **
|
|
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
|
-
|
|
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
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
26
|
+
“analyze the data source”
|
|
27
|
+
“validate the graph”
|
|
28
|
+
“generate the SRS”
|
|
29
|
+
“refresh the index”
|
|
30
30
|
```
|
|
31
31
|
|
|
32
|
-
Then:
|
|
32
|
+
Then: “generate basic design” → “generate 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 |
|
|
37
|
-
|
|
38
|
-
| New or changed data source |
|
|
39
|
-
| Check graph |
|
|
40
|
-
| Regenerate docs |
|
|
41
|
-
|
|
|
42
|
-
|
|
|
43
|
-
|
|
|
44
|
-
|
|
|
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/ →
|
|
50
|
-
→
|
|
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.
|