Simulacrum

Getting started

Install the CLI, activate your license, generate your first project, and run the dev server.

Install the CLI

Install Simulacrum globally so simulate is available everywhere:

bash
npm install -g simulacrum-cli

Verify the install:

bash
simulate --version

Activate your license

After purchase, copy the license key from your Lemon Squeezy receipt email, then run:

bash
simulate activate YOUR_LICENSE_KEY

You should see confirmation with your tier and email. Use simulate status any time to check activation.

Generate your first project

Pick a template and a project name:

bash
npx simulate ecommerce my-store

The CLI walks through database adapter, auth providers, payments, and optional flags. Use --minimal for non-interactive defaults.

Run the dev server

bash
cd my-store
npm install
npm run dev

Open the URL printed in the terminal—typically http://localhost:3000.

Next steps

If activation fails, confirm outbound HTTPS access and that you are pasting the full key from the receipt—no extra spaces.