@thryvlabs/create-dex-prototype

Generate a local DEX Design System prototyping workspace (React or Vue) with a single command. This CLI is for exploratory UI and design-system work, not for bootstrapping production applications.

Positioning (terminology)

• Use this for: prototype workspaces, spikes, demos, and iterating on DEX-backed UI before any production rollout.
• Do not use this for: “greenfield app” or production service bootstrap — treat outputs as disposable or merge-target prototypes, not canonical app starters.

Usage

No installation is required.

Interactive CLI

npx @thryvlabs/create-dex-prototype

You'll be prompted for:

1. Prototype workspace name — directory to create; random name generated or use your own
2. Framework — React or Vue
3. AI coding tool — Select your AI coding tool (helps facilitate MCP setup)

If you already know the name of your prototype, you can pass it in the CLI command. This will be used for the directory of the prototype; it's advised you use kebab case, pascal case, or some other casing that doesn't use spaces.

npx @thryvlabs/create-dex-prototype my-dex-prototype

CLI flags

npx @thryvlabs/create-dex-prototype my-dex-prototype --dex-version 1.2.3

| Flag | Description | Default | | ----------------- | -------------------------------- | ---------- | | --dex-version | Override the DEX package version | (latest) | | -h, --help | Show help message | | | -v, --version | Show version number | |

What you get (planned)

my-dex-prototype/
  package.json
  vite.config.ts
  tsconfig.json
  postcss.config.js
  index.html
  src/
    main.tsx          # (or main.ts for Vue)
    App.tsx           # (or App.vue)
    styles.css
    Header.tsx        # Theme/color-scheme switcher
    home/
    contacts/
    automations/
  .gitignore
  .prettierrc
  eslint.config.mjs
  AGENTS.md           # AI agent instructions (if AI tool selected)
  CLAUDE.md           # Claude-specific config (if applicable)

Development

Local installation

If you want to test a pre-release or run a local build, you'll need to build + pack + install. It's recommended you uninstall when finished with testing to prevent issues later.

# Install dependencies
pnpm install

# Build the CLI
pnpm build

# Watch mode
pnpm dev

# Run tests
pnpm test

# Type check
pnpm typecheck

# Lint
pnpm lint

# Pack
pnpm pack
# This will tarball the currently set version in the project root.

# Install the version that you packed
npm install thryvlabs-create-dex-prototype-*.*.*.tgz

# Run local install
npx create-dex-prototype

Publishing

The CLI is published as @thryvlabs/create-dex-prototype.

pnpm build
npm publish

License

GPL-3.0