create-quilltap-theme 2.0.0 → 2.0.2

package/README.md

@@ -1,27 +1,31 @@
 # create-quilltap-theme
 
-Scaffold a new Quilltap theme plugin with a single command.
+Scaffold a new Quilltap theme with a single command.
 
 ## Usage
 
-### Using npm init (recommended)
+### Bundle format (default, recommended)
 
 ```bash
-npm init quilltap-theme my-theme
+npx create-quilltap-theme my-theme
 ```
 
-### Using npx
+This creates a `.qtap-theme` bundle directory — a simple, declarative format with JSON tokens, CSS, and fonts. No build tools, npm packages, or TypeScript required.
+
+### Legacy plugin format (deprecated)
 
 ```bash
-npx create-quilltap-theme my-theme
+npx create-quilltap-theme my-theme --plugin
 ```
 
+Creates an npm-based theme plugin. This format is deprecated; use bundles for new themes.
+
 ### Interactive mode
 
 Run without arguments for interactive prompts:
 
 ```bash
-npm init quilltap-theme
+npx create-quilltap-theme
 ```
 
 ### Skip prompts
@@ -29,11 +33,24 @@ npm init quilltap-theme
 Use `-y` or `--yes` to use defaults:
 
 ```bash
-npm init quilltap-theme my-theme --yes
+npx create-quilltap-theme my-theme --yes
 ```
 
 ## What gets created
 
+### Bundle format (default)
+
+```
+my-theme/
+├── theme.json            # Theme manifest with metadata and tokens
+├── tokens.json           # Design tokens (colors, fonts, spacing)
+├── styles.css            # CSS component overrides
+├── fonts/                # Custom font files (add .woff2 files here)
+└── README.md             # Documentation
+```
+
+### Plugin format (--plugin)
+
 ```
 qtap-plugin-theme-my-theme/
 ├── package.json          # npm package configuration
@@ -57,6 +74,7 @@ qtap-plugin-theme-my-theme/
 
 | Option | Description |
 |--------|-------------|
+| `--plugin` | Create a legacy npm plugin instead of a bundle |
 | `-y, --yes` | Skip prompts and use default values |
 | `-h, --help` | Show help message |
 
@@ -69,38 +87,49 @@ When run without `--yes`, you'll be asked:
 3. **Author name** - Your name
 4. **Author email** - Your email
 5. **Primary color** - Main theme color in HSL format
-6. **Include CSS overrides?** - Whether to create styles.css
-7. **Include Storybook?** - Whether to set up Storybook for development
+6. **Include CSS overrides?** - Whether to create styles.css (bundle and plugin)
+7. **Include Storybook?** - Whether to set up Storybook for development (plugin only)
 
 ## Next steps after scaffolding
 
+### Bundle themes
+
 ```bash
-cd qtap-plugin-theme-my-theme
-npm install
-npm run build
+cd my-theme
+# Edit theme.json, tokens.json, and styles.css
+# Then install into Quilltap:
+npx quilltap themes install .
+# Or validate first:
+npx quilltap themes validate .
 ```
 
-To preview in Storybook (if included):
+### Plugin themes (deprecated)
 
 ```bash
-npm run storybook
+cd qtap-plugin-theme-my-theme
+npm install
+npm run build
+npm publish --access public
 ```
 
-To publish:
+## Managing themes via CLI
 
 ```bash
-npm publish --access public
+npx quilltap themes list                    # List all installed themes
+npx quilltap themes install my.qtap-theme   # Install a bundle
+npx quilltap themes validate my.qtap-theme  # Validate without installing
+npx quilltap themes export earl-grey        # Export any theme as a bundle
+npx quilltap themes search "dark"           # Search registries
+npx quilltap themes update                  # Check for updates
 ```
 
 ## Documentation
 
-Every scaffolded theme includes a complete development guide at `docs/THEME_PLUGIN_DEVELOPMENT.md`.
-
 For the latest online documentation:
 
-- [Theme Plugin Development Guide](https://github.com/foundry-9/quilltap/blob/main/docs/THEME_PLUGIN_DEVELOPMENT.md)
+- [Theme Plugin Development Guide](https://github.com/foundry-9/quilltap/blob/main/docs/THEME_PLUGIN_DEVELOPMENT.md) (legacy plugin format)
 - [Plugin Manifest Reference](https://github.com/foundry-9/quilltap/blob/main/docs/PLUGIN_MANIFEST.md)
-- [@quilltap/theme-storybook](https://www.npmjs.com/package/@quilltap/theme-storybook)
+- [@quilltap/theme-storybook](https://www.npmjs.com/package/@quilltap/theme-storybook) (for plugin development with Storybook)
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-quilltap-theme",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "Scaffold a new Quilltap theme plugin",
   "main": "dist/index.js",
   "bin": {
@@ -35,8 +35,8 @@
     "node": ">=18.0.0"
   },
   "devDependencies": {
-    "@types/node": "^24.10.13",
-    "esbuild": "^0.27.0",
-    "typescript": "^5.0.0"
+    "@types/node": "^22.19.15",
+    "esbuild": "^0.27.4",
+    "typescript": "^5.9.3"
   }
 }

package/templates/docs/THEME_PLUGIN_DEVELOPMENT.md.template

@@ -560,7 +560,7 @@ For advanced customization, create `styles.css` with component overrides. This u
 | `.qt-button`, `.qt-button-primary`, `.qt-button-secondary`, `.qt-button-ghost`, `.qt-button-destructive` | Button variants |
 | `.qt-button-sm`, `.qt-button-lg`, `.qt-button-icon` | Button sizes |
 | `.qt-card`, `.qt-card-header`, `.qt-card-body`, `.qt-card-footer` | Card components |
-| `.qt-card-interactive`, `.qt-entity-card`, `.qt-panel` | Card variants |
+| `.qt-card-interactive`, `.qt-entity-card`, `.qt-character-card`, `.qt-panel` | Card variants |
 | `.qt-input`, `.qt-textarea`, `.qt-select` | Form inputs |
 | `.qt-badge`, `.qt-badge-primary`, `.qt-badge-secondary`, `.qt-badge-outline` | Badges |
 | `.qt-avatar`, `.qt-avatar-sm`, `.qt-avatar-lg`, `.qt-avatar-xl` | Avatars |
@@ -588,6 +588,7 @@ Override these variables for consistent component styling:
 --qt-card-padding
 --qt-card-shadow
 --qt-card-border
+--qt-character-card-padding
 
 /* Inputs */
 --qt-input-radius