AstroE-commerce

astro-njx-maison — Astro Ecommerce Template

By njbSaab

Maison is a free classic e-commerce theme built on Astro, presented in a printed-archive style with three fictional houses and a patron cabinet, supporting live currency switching and optional Shopify Storefront API integration.

Open Source Site Download Source ZIP

Explore the design

Compare the page layouts and mobile experience. Open any screenshot for a closer look.

3 previews

Desktop homepage1 / 3

Visit websiteOpens in a new tab

Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 3

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-05View source

What stands out

A quick read of the recorded project description.

Printed editorial style: Playfair Display headings, Karla body text, Cousine small-caps labels, warm paper background, and hairline dividers

Three independent houses: Geneva watchmaking, Savile Row bespoke, and Paris antiquarian books, each with a manifesto, mega menu, search suggestions, and a 36-item catalog

Faceted filter bar: filter by valuation range, house, material, era, and availability status, with live counts and print-style labels

One-of-one transaction flow: private vault, selection bag with total valuation, and a "Request the keeper" request mechanism

Patron cabinet: stats bar, orders with four-step craft progress, activity log, residences, and privileges

Live currency switching: USD, EUR, and GBP, with site-wide prices recalculated instantly

Template Details

Maison is an Astro e-commerce theme positioned as a "printed archive" rather than a conventional online store. Visually, it uses serif typefaces, a warm paper background, hairline dividers, and a single wine-red accent color, giving the whole a print-like editorial design feel. The theme includes three fictional houses: a Geneva watchmaker (est. 1888), a Savile Row bespoke workshop (est. 1904), and a Paris antiquarian cabinet (est. 1792). Each house has its own manifesto, mega menu, search suggestions, and a 36-item catalog. Product browsing offers a faceted filter bar that filters by valuation range, house, material, era, and availability status, with live counts. The transaction flow uses a "one-of-one" model: every item is a unique piece, with a private vault, a selection bag showing a total valuation, and a "Request the keeper" request process instead of standard checkout. The patron cabinet includes a stats bar, orders with a four-step craft progress (preparation → handcrafting → inspection → dispatch), an activity log, residences, and privileges. Site-wide prices support live switching between USD, EUR, and GBP. Search is full-screen in a serif style, invoked via ⌘K or /, and covers all three houses. For SEO, it provides static product records, Product and AggregateRating JSON-LD, Open Graph, and a sitemap-friendly structure. By default, the theme uses a built-in mock catalog and runs without keys or accounts; the commerce layer is based on a provider pattern and can switch to the Shopify Storefront API via two environment variables. The tech stack is Astro, Tailwind CSS, and nanostores, outputting a static site deployable on Cloudflare Pages, Netlify, Vercel, or GitHub Pages. The code is MIT-licensed and free for personal and commercial projects.

AstroE-commerce

Is it right for your project?

Use Cases

Building a luxury or antique showcase e-commerce site with a printed-archive character
Projects that need multiple houses or brands to share one theme while each has its own navigation and catalog
One-of-one sales scenarios where a request-based or appointment-based process replaces standard checkout
Static e-commerce frontends that need faceted filtering, live currency switching, and a customer account panel
Projects using Astro static output and planning to deploy to Cloudflare Pages, Netlify, Vercel, or GitHub Pages

Suitable For

Brands in luxury, antiques, or bespoke workshops that emphasize editorial design and archival storytelling
Collection-style e-commerce sites that need independent catalogs and navigation for multiple houses
One-of-one sellers who accept a request-based transaction flow rather than standard checkout
Developers using Astro who want to start quickly with mock data and optionally integrate Shopify later

Getting started & customization

Use these recorded setup notes alongside the repository instructions for your chosen version.

1
After cloning the repository, run npm install and npm run dev; the theme uses a built-in mock catalog by default and requires no keys or accounts
2
To integrate Shopify, set the three environment variables COMMERCE_PROVIDER=shopify, SHOPIFY_STORE_DOMAIN, and SHOPIFY_STOREFRONT_TOKEN, then rebuild
3
Brand customization mainly involves editing scripts/gen-catalog.py (houses, categories, and the 36-item catalog) and src/styles/global.css (paper, ink, and accent color tokens)
4
The code is MIT-licensed; when distributing, retain the copyright notice and the full license text; third-party assets such as demo images, fonts, and icons must be checked separately for licensing
5
External services such as domains, hosting, databases, and payments may incur additional costs and are not covered by the code license

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This entry covers the free version under the MIT license in the public repository; the free scope applies to that version's code and does not imply that external services or third-party assets are free.

Must comply with when using

The code of this version may be used, modified, used commercially, and distributed free of charge.
When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.

Additional costs & items to verify

Demo images, fonts, icons, and other third-party assets must be checked under their respective licenses and cannot be judged solely by the code's MIT license.
External services such as domains, hosting, databases, payments, or AI may incur separate charges.
Integrating live Shopify products requires configuring environment variables and rebuilding; by default, only the built-in mock catalog is used and no real product data is included.
Using the Shopify commerce layer requires your own Shopify store domain and Storefront API access token, which are external service dependencies.
A backlink to njxui.dev is only a suggestion, not a requirement, and does not affect free use.

View Original Text Basis

Permission is hereby granted, free of charge
Original License Text

The commerce layer is provider-based. Two env vars switch it from mock data to the Shopify Storefront API:
Original README

COMMERCE_PROVIDER=shopify SHOPIFY_STORE_DOMAIN=your-store.myshopify.com SHOPIFY_STOREFRONT_TOKEN=your-storefront-access-token
Original README

A link back to [njxui.dev](https://njxui.dev) is appreciated but not required.
Original README

https://github.com/njbSaab/astro-njx-maison/blob/main/LICENSE https://github.com/njbSaab/astro-njx-maison/blob/main/README.md

Compiled by DeepSeek based on repository license and README ·2026-10-05. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.

Project checks & description sources

Template Information

Source platforms: Astro Themes
Documentation and maintenance reference score: More documented · 80 / 100
Technologies: Astro
Website type: E-commerce

How this score is calculated

Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.

What to verify for this project

Repository update recorded: 2026-09-26
Screenshot last checked: 2026-10-05

A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.

The catalog identifies Astro as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.

Use a selection guide →

How this description was prepared

AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.

Review declaration: [email protected] · 2026-10-06

Inspect the recorded source material

SHA-256: 73eba6a2f856fd706fe999f533e6ba68a653f08f70f042e83fe26f1e89b5d857

2026-10-05T21:59:16.205Z

Source file / repository

# Maison — a printed archive, not a webshop

[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/njbSaab/astro-njx-maison) [![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/njbSaab/astro-njx-maison)

**Free classic Astro e-commerce theme.** Serif typography on warm paper, hairline rules,
three archive houses and a patron cabinet — no neon, no glow, no checkout theatre.

**[Live demo →](https://astro-njx-maison.pages.dev)** ·
[More themes at njxui.dev](https://njxui.dev/themes)

![Maison — home page](docs/preview.jpg)

## What's inside

- **Printed editorial design** — Playfair Display headlines, Karla text, Cousine
  small-caps labels, one bordeaux accent, hairline rules everywhere.
- **Three archive houses** in one theme — a Geneva watchmaking maison (est. 1888),
  a Savile Row bespoke atelier (est. 1904) and a Paris antiquarian cabinet
  (est. 1792) — each with its own manifesto, mega menu, search suggestions and
  36-piece catalogue.
- **Faceted archive rail** — valuation range, house, material, era, availability;
  live counts and printed chips.
- **One-of-one commerce** — every piece is unique: a private vault, an acquisition
  bag with a total valuation and a "Request the keeper" flow instead of a checkout.
- **Patron cabinet** — stats strip, orders with a four-step craft progress
  (Preparation → Hand-crafting → Inspection → Dispatched), activity log,
  residences, privileges.
- **Live currency switch** — USD / EUR / GBP; every price on the site reprices
  instantly.
- **Full-screen serif search** on `⌘K` and `/` across all three houses.
- **SEO-ready** — static piece records with Product + AggregateRating JSON-LD,
  Open Graph, sitemap-friendly.

## Quick start

```bash
git clone https://github.com/njbSaab/astro-njx-maison.git
cd astro-njx-maison
npm install
npm run dev
```

The theme runs out of the box on the bundled mock catalogue — no keys, no accounts.

## Connect Shopify (optional)

The commerce layer is provider-based. Two env vars switch it from mock data to
the Shopify Storefront API:

```bash
COMMERCE_PROVIDER=shopify
SHOPIFY_STORE_DOMAIN=your-store.myshopify.com
SHOPIFY_STOREFRONT_TOKEN=your-storefront-access-token
```

Rebuild, and the archive renders your live products.

## Stack

[Astro 5](https://astro.build) · [Tailwind CSS v4](https://tailwindcss.com) ·
[nanostores](https://github.com/nanostores/nanostores) — static output, deploys
anywhere (Cloudflare Pages, Netlify, Vercel, GitHub Pages).

## Rebrand in two files

1. `scripts/gen-catalog.py` — houses, categories and the 36-piece catalogue.
2. `src/styles/global.css` — the paper, ink and accent tokens.

## More themes

Maison is the free theme of the classic line at **[njxui.dev](https://njxui.dev/themes)** —
alongside [Heritage](https://njxui.dev/themes/heritage) (classic luxury with a
full checkout, light + dark) and [Lumière](https://njxui.dev/themes/lumiere)
(three boutiques on one warm-paper engine), plus a modern line and free
Shopify-ready storefronts.

## License

[MIT](LICENSE) — free for personal and commercial projects. A link back to
[njxui.dev](https://njxui.dev) is appreciated but not required.

Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.

astro-shopify

A lightweight Shopify headless ecommerce starter template built with Astro and Svelte, integrating the Shopify Storefront API for product and inventory data, with built-in cart state management and basic add-to-cart and checkout flow.

Astro · E-commerce

astro-ecommerce

Astro Ecommerce is a Creative Tim e-commerce Astro starter template under the MIT license, with 70+ coded elements, 30+ blocks, and landing, product, and shopping cart example pages.

Astro · E-commerce

astro-medusa-starter

An open-source e-commerce storefront starter built on Astro and Medusa v2, using a static-first architecture with React islands, multi-region routing, Stripe checkout, and Cloudflare Workers deployment.

Astro · E-commerce

sanity-astro-club

An Astro template for showcasing and selling digital works, with content managed through an extensible Sanity Studio and checkout sessions generated via the Polar API.

Astro · E-commerce

atelier-ko

Atelier Kō is a minimalist Astro ecommerce theme for small furniture workshops and craft catalogs with a limited body of work.

Astro · E-commerce

starter-astro

An Astro e-commerce storefront starter template that separates content from transactions: Markdown content collections manage pages, copy, and product images, generating static HTML at build time, while WireGum components handle live pricing, variants, cart, and Stripe Checkout.

Astro · E-commerce