Package Exports

@webjsdev/cli/bin/webjs.js
@webjsdev/cli/lib/create.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@webjsdev/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@webjsdev/cli

CLI for webjs: scaffold, develop, build, and run webjs apps.

Installing this package gives you the webjs command.

Install

Install once, globally:

npm i -g @webjsdev/cli

Then scaffold a new app anywhere:

webjs create my-app
cd my-app && npm install && npm run dev
# → http://localhost:3000

One-shot without global install:

npx @webjsdev/cli create my-app
cd my-app && npm install && npm run dev

Commands

webjs create <name>            # scaffold a full-stack app (default)
webjs create <name> --template api   # backend-only API app
webjs create <name> --template saas  # auth + dashboard + Prisma User model

webjs dev                      # dev server with live reload
webjs start                    # production server (no build step, serves source directly)
webjs check                    # validate project conventions
webjs test                     # run server + browser tests
webjs db <prisma-subcommand>   # prisma passthrough (saas template)

webjs ui init                  # initialise @webjsdev/ui in this project
webjs ui add <names...>        # copy components from the registry (https://ui.webjs.dev/registry/<name>.json)
webjs ui list                  # list every component available in the registry

webjs ui proxies to @webjsdev/ui, an AI-first component library + CLI that copies sources into your project: class helpers (buttonClass, cardClass, …) for the visual primitives and a small set of stateful custom elements (<ui-dialog>, <ui-tabs>, <ui-popover>) where state matters. The package is a hard dependency of @webjsdev/cli, so installing the CLI gives you webjs ui automatically. See https://ui.webjs.dev for the catalogue.

Scaffolded templates

The scaffold seeds opinionated defaults so AI agents produce consistent code:

AGENTS.md + CONVENTIONS.md (the machine-readable contract)
.claude/, .cursorrules, .windsurfrules, .github/copilot-instructions.md
test/<feature>/ (with optional browser/ / e2e/ subfolders per kind) with example tests
Tailwind CSS via CLI (no browser runtime at build time)
TypeScript, .editorconfig, .gitignore

See the full framework docs at https://github.com/vivek7405/webjs.

License

MIT