Live preview

Pages

Every page is a real, interactive preview — the cart is shared between them.

What is included

• Persistent cart with drawer and live badge
• Instant filters: category, price, colour, rating, stock
• Checkout with shipping, tax and promo codes
• Zero runtime dependencies, WCAG AA, mobile-first
• Product illustrations included — no images needed
• Light and dark mode with a toggle
• Live notices: cart toasts, sale countdown, low stock and recent purchases

Install & use

1. Install the package

   bash Copy

   npm install astro-component-kit

   npm install astro-component-kit

2. Create one Astro page per template page

   src/pages/index.astro

   astro Copy

   ---
   import { StoreHomePage } from 'astro-component-kit/templates/ecommerce';
   ---
   
   <StoreHomePage />

   --- import { StoreHomePage } from 'astro-component-kit/templates/ecommerce'; --- <StoreHomePage />

   src/pages/shop.astro

   astro Copy

   ---
   import { StoreCategoryPage } from 'astro-component-kit/templates/ecommerce';
   ---
   
   <!-- Category links use /shop/?category=audio -->
   <StoreCategoryPage />

   --- import { StoreCategoryPage } from 'astro-component-kit/templates/ecommerce'; --- <!-- Category links use /shop/?category=audio --> <StoreCategoryPage />

   src/pages/product/[slug].astro

   astro Copy

   ---
   import { StoreProductPage, demoStore } from 'astro-component-kit/templates/ecommerce';
   
   export function getStaticPaths() {
     return demoStore.products.map((p) => ({ params: { slug: p.slug } }));
   }
   ---
   
   <StoreProductPage slug={Astro.params.slug} />

   --- import { StoreProductPage, demoStore } from 'astro-component-kit/templates/ecommerce'; export function getStaticPaths() { return demoStore.products.map((p) => ({ params: { slug: p.slug } })); } --- <StoreProductPage slug={Astro.params.slug} />

   src/pages/checkout.astro

   astro Copy

   ---
   import { StoreCheckoutPage } from 'astro-component-kit/templates/ecommerce';
   ---
   
   <StoreCheckoutPage />

   --- import { StoreCheckoutPage } from 'astro-component-kit/templates/ecommerce'; --- <StoreCheckoutPage />

3. Use your own catalogue, currency and routes

   Spread the demo store and replace what you need. Products accept a real image or one of 16 built-in illustrations.

   astro Copy

   ---
   // src/pages/index.astro — same store + routes on every page
   import { StoreHomePage, demoStore, type StoreConfig } from 'astro-component-kit/templates/ecommerce';
   
   const store: StoreConfig = {
     ...demoStore,
     name: 'My Shop',
     currency: 'EUR',
     locale: 'es-ES',
     cartKey: 'my-shop-cart',
     products: [
       {
         slug: 'linen-shirt',
         name: 'Linen Shirt',
         price: 59,
         category: 'apparel',
         image: '/products/linen-shirt.webp', // or icon: 'shirt'
         sizes: ['S', 'M', 'L'],
         rating: 4.7,
         reviews: 40,
       },
     ],
   };
   ---
   
   <StoreHomePage store={store} routes={{ home: '/', shop: '/shop/', product: '/product/', checkout: '/checkout/' }} />

   --- // src/pages/index.astro — same store + routes on every page import { StoreHomePage, demoStore, type StoreConfig } from 'astro-component-kit/templates/ecommerce'; const store: StoreConfig = { ...demoStore, name: 'My Shop', currency: 'EUR', locale: 'es-ES', cartKey: 'my-shop-cart', products: [ { slug: 'linen-shirt', name: 'Linen Shirt', price: 59, category: 'apparel', image: '/products/linen-shirt.webp', // or icon: 'shirt' sizes: ['S', 'M', 'L'], rating: 4.7, reviews: 40, }, ], }; --- <StoreHomePage store={store} routes={{ home: '/', shop: '/shop/', product: '/product/', checkout: '/checkout/' }} />

New e-commerce components 22

Built for this template and available on their own in the library.

Reused library components

Existing components the template is assembled from.

• Badge
• Numeric Stepper
• Animated Input
• Modern Select
• Custom Radio Group
• Success Checkmark
• Step Breadcrumb Bar
• Footer Mega Section
• Logo Cloud Section
• CTA Newsletter Section