@skyfall_ai/bazaar 0.1.0

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 ADDED
@@ -0,0 +1,51 @@
1
+ # Skyfall Bazaar
2
+
3
+ Curated, conversion-aware eCommerce UI kit for modern storefronts — product discovery, trust, and checkout, built as the commerce vertical of the Skyfall design-system family.
4
+
5
+ ## Quick Start
6
+
7
+ ```bash
8
+ npm install
9
+ npm run dev
10
+ ```
11
+
12
+ ## Scripts
13
+
14
+ | Command | Description |
15
+ |---------|-------------|
16
+ | `npm run dev` | Start Storybook dev server |
17
+ | `npm run build` | Build the library for distribution |
18
+ | `npm run build-storybook` | Build static Storybook site |
19
+ | `npm run chromatic` | Publish stories to Chromatic |
20
+ | `npm run typecheck` | Run TypeScript type checking |
21
+
22
+ ## Architecture
23
+
24
+ ```
25
+ src/
26
+ tokens/ Design tokens (CSS variables + TypeScript constants)
27
+ components/ Core components (shared Skyfall primitives)
28
+ commerce/ Bazaar commerce components (discovery, PDP, cart, checkout, account, trust, editorial)
29
+ charts/ Chart primitives wrapping recharts
30
+ fixtures/ Mock commerce data for stories
31
+ utils/ Shared utilities
32
+ hooks/ Custom React hooks
33
+ types/ Shared TypeScript types
34
+ stories/ Overview, Introduction, Installation, Tokens
35
+ ```
36
+
37
+ ## Design Principles
38
+
39
+ 1. **Polished & trustworthy** — Premium feel that earns confidence
40
+ 2. **Product-forward** — Imagery is the hero; chrome steps back
41
+ 3. **Conversion-aware** — Friction is measured and intentional
42
+ 4. **Editorially composed** — Generous spacing, refined type, restrained accents
43
+ 5. **Mobile-first commerce** — Core shopping patterns optimized for phone-shaped screens
44
+
45
+ ## Family
46
+
47
+ Skyfall Bazaar is part of the Skyfall design-system family. It shares its foundation, structure, and primitives with [Skyfall Aegis](https://github.com/skyfall-consulting/skyfall-aegis) (healthcare), [Skyfall Beacon](https://github.com/skyfall-consulting/skyfall-beacon) (edtech), and Skyfall Ledger (fintech) — wrapped in a commerce identity.
48
+
49
+ ## License
50
+
51
+ MIT