LocalStage

LocalStage is a local development server and CLI for Basker themes. Run a theme locally while using live data from a Basker CMS environment.

Install

npm install -g @baskerhq/localstage

Usage

From a theme directory:

basker theme dev

Use a custom CMS URL:

BASKER_CMS_URL=https://example.com LOCALSTAGE_THEME_PATH=/path/to/theme basker theme dev

Open http://localhost:9292 and sign in.

Theme Structure

your_theme/
├── layouts/
│   └── default.liquid
├── templates/
│   ├── page.liquid
│   ├── post.liquid
│   └── 404.liquid
├── snippets/
└── assets/

Environment Variables

• BASKER_CMS_URL - optional CMS base URL
• LOCALSTAGE_THEME_PATH - path to a theme directory

Commands

• basker theme dev - start the local dev server
• basker theme check - validate theme structure

Troubleshooting

• Ensure your CMS URL is reachable and your account can access the target tenant.
• Verify the theme path exists and contains layouts/ and templates/.