@aurora-studio/starter-core
v0.1.42
Published
Shared Aurora storefront primitives (SDK helpers, Holmes bridge, commerce UI) for marketplace templates.
Downloads
2,269
Readme
@aurora-studio/starter-core
Shared Aurora storefront primitives for Next.js marketplace templates: SDK helpers (lib/aurora), Holmes script + signal bridge (holmes-events), formatting, and reusable commerce UI (cart, product images, search, auth, store context).
Install with @aurora-studio/sdk. Configure transpilePackages: ["@aurora-studio/starter-core", "@aurora-studio/sdk"] in next.config.
Changelog
- 0.1.40 — Maintenance.
- 0.1.39 — Peer/dev
@aurora-studio/sdk^0.2.41(published docs: getting-started, holmes-storefront). Extensivedocs/(storefront overview, Holmes integration, CMS rails, content regions); npm package includesdocs/. - 0.1.38 —
aurora-generate-content-regionsCLI; resolve template id frompackage.jsonon Vercel (path0checkouts).
Documentation
| Doc | Audience |
|-----|----------|
| docs/README.md | Index — start here |
| docs/storefront-overview.md | Install, env vars, createAuroraClient, getStoreConfig, search/checkout |
| docs/holmes-integration.md | ConditionalHolmesScript, window.holmes, holmes-events (search, cart, product view, combo/recipe, bundle events) |
| docs/cms-rails-and-fragments.md | Editorial CMS rails, getHomePersonalization, HomePersonalizationResult / sections, template StoreContentRails pattern |
| docs/content-regions.md | aurora-generate-content-regions CLI, init/content-regions.json, Vercel, Studio manifest |
New to Aurora entirely? Read the SDK first: Getting started and Holmes & storefront markup.
Reference templates: aurora-template-grocery, aurora-template-travel, aurora-template-store, aurora-template-hotels — each wires starter-core into a full app (API routes, layout, CMS rails).
Package exports
See src/index.ts: lib/* (aurora, holmes-events, format-price, …) and components (CartProvider, ConditionalHolmesScript, HolmesProductViewTracker, SearchDropdown, …).
CMS content regions (build tool)
This package publishes the aurora-generate-content-regions CLI. It scans a template’s app/ and components/ and writes init/content-regions.json. Details: docs/content-regions.md.
Links
- SDK: github.com/Purple-Napkin/aurora-sdk
- Aurora Studio: aurora.purple-napkin.com
- Holmes directives: @aurora-studio/sdk docs — holmes-storefront
