create-logiteria

Create Logiteria Commerce storefronts with one command.

Quick Start

# Using npm create shorthand
npm create logiteria

# With project name
npx create-logiteria my-store

# Global install
npm i -g create-logiteria
logiteria create my-store

Interactive Mode

Running without flags launches an interactive wizard:

  ██╗      ██████╗  ██████╗ ██╗████████╗███████╗██████╗ ██╗ █████╗
  ...
  Commerce Platform

  ◆ Project name
  │ my-store
  ◆ Select a theme
  │ ● Dawn — polished, clean design (recommended)
  │ ○ Starter — bare bones, full control
  ◆ Store URL
  │ https://my-store.lumocomm.com
  ◆ Package manager
  │ ● pnpm (detected)

Non-Interactive (CI)

logiteria create my-store \
  --theme dawn \
  --store-url https://api.example.com \
  --pm pnpm \
  --yes

Commands

logiteria create [name]

Scaffold a new Logiteria storefront.

| Option | Description | Default | |--------|-------------|---------| | --theme <theme> | Theme to use (dawn, starter) | dawn | | --store-url <url> | Store API URL | (prompted) | | --pm <manager> | Package manager (npm, pnpm, yarn, bun) | auto-detected | | -y, --yes | Skip prompts, use defaults | false |

logiteria info

Show project diagnostics: SDK version, Node version, store URL, API health check.

Themes

| Theme | Description | |-------|-------------| | Dawn | Polished, clean design with Inter font. Indigo primary, smooth transitions. | | Starter | Bare bones with system fonts. Blue primary. Full control for custom designs. |

Both themes include dark mode support via prefers-color-scheme.

What You Get

my-store/
├── app/                    # Next.js App Router pages
│   ├── layout.tsx          # Root layout
│   ├── page.tsx            # Homepage
│   ├── shop/               # Product listing
│   ├── product/[slug]/     # Product detail
│   ├── collections/        # Collections
│   ├── cart/               # Shopping cart
│   ├── checkout/           # Checkout flow
│   ├── auth/               # Login & register
│   └── account/            # Customer account
├── components/
│   ├── layout/             # Header, Footer, MobileNav
│   ├── product/            # ProductCard, ProductGrid, etc.
│   ├── cart/               # CartDrawer, CartItem, etc.
│   ├── checkout/           # CheckoutForm, AddressForm
│   └── shared/             # Price, Badge, Breadcrumb, etc.
├── lib/
│   ├── commerce.ts         # SDK configuration
│   └── utils.ts            # Utilities
├── styles/
│   └── globals.css         # Theme CSS (design tokens)
├── .env.local              # Store URL
└── package.json

Requirements

• Node.js 18+
• A Logiteria Commerce instance (store URL)

License

MIT