create-bestax 4.0.2 → 4.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Alex Smith
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,KAAK,CAAC,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,SAAS,EAAE,QAAQ,EAG/B,CAAC;AAEF,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AACpD,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,kBAAkB,QAAsB,CAAC;AAEtD,eAAO,MAAM,QAAQ;;;;;;;wCAaQ,MAAM;uCAEP,MAAM;sCACP,MAAM;4CAEA,MAAM;;;;;CAM7B,CAAC;AASX,eAAO,MAAM,WAAW,QAed,CAAC;AAEX,eAAO,MAAM,OAAO;;;;;;CAOV,CAAC;AAOX,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAK9D,CAAC;AAKF,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,SAAS,GACpB,aAAa,MAAM,EACnB,8BAA8B,eAAe,KAC5C,MAkIF,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IAIrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,cAAc,EAAE,WAAW,EA6CvC,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,eAAO,MAAM,aAAa,EAAE,WAAW,EA4CtC,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,KAAK,CAAC,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,SAAS,EAAE,QAAQ,EAG/B,CAAC;AAEF,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AACpD,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,kBAAkB,QAAsB,CAAC;AAEtD,eAAO,MAAM,QAAQ;;;;;;;wCAaQ,MAAM;uCAEP,MAAM;sCACP,MAAM;4CAEA,MAAM;;;;;CAM7B,CAAC;AASX,eAAO,MAAM,WAAW,QAed,CAAC;AAEX,eAAO,MAAM,OAAO;;;;;;CAOV,CAAC;AAOX,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAK9D,CAAC;AAKF,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,SAAS,GACpB,aAAa,MAAM,EACnB,8BAA8B,eAAe,KAC5C,MAoIF,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IAIrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,cAAc,EAAE,WAAW,EA6CvC,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,eAAO,MAAM,aAAa,EAAE,WAAW,EA4CtC,CAAC"}

package/dist/constants.js

@@ -179,7 +179,9 @@ Read skill \`references/\` files with absolute paths — the shell's cwd is not
 
 \`.claude/launch.json\` declares this app's dev server for Claude Code's browser preview
 (\`npm run dev\` on port 5173, \`--strictPort\`) — start it from there rather than rediscovering
-the command.
+the command. \`--strictPort\` failing because 5173 is busy means an orphaned dev server from an
+earlier session owns the port — kill the listener (\`lsof -tiTCP:5173 -sTCP:LISTEN | xargs kill\`)
+and relaunch; don't move the app to another port.
 
 ## Docs
 

package/dist/display.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../src/display.ts"],"names":[],"mappings":"AAIA,wBAAgB,aAAa,IAAI,IAAI,CAMpC;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAwBtD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAElD;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../src/display.ts"],"names":[],"mappings":"AAKA,wBAAgB,aAAa,IAAI,IAAI,CAMpC;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CA2BtD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAElD;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/dist/display.js

@@ -1,6 +1,7 @@
 import chalk from 'chalk';
 import figures from 'figures';
 import { MESSAGES } from './constants.js';
+import { detectPackageManager } from './package-manager.js';
 export function displayHeader() {
     console.log();
     console.log(chalk.cyan('━'.repeat(50)));
@@ -14,9 +15,12 @@ export function displaySuccess(targetDir) {
     console.log();
     console.log(chalk.bold(MESSAGES.NEXT_STEPS));
     console.log();
+    // Mirror the package manager that invoked the CLI — `<pm> install` and
+    // `<pm> run dev` are valid for all four supported PMs.
+    const pm = detectPackageManager();
     console.log(chalk.cyan(`  cd ${targetDir}`));
-    console.log(chalk.cyan('  pnpm install'));
-    console.log(chalk.cyan('  pnpm dev'));
+    console.log(chalk.cyan(`  ${pm} install`));
+    console.log(chalk.cyan(`  ${pm} run dev`));
     console.log();
     console.log(chalk.gray('  Your app includes a beautiful logo-centric homepage'));
     console.log(chalk.gray('  showcasing Bestax, Vite, and React branding.'));

package/dist/file-system.d.ts

@@ -2,7 +2,7 @@ export declare function checkDirectoryExists(targetPath: string): Promise<boolea
 export declare function isDirectoryEmpty(targetPath: string): Promise<boolean>;
 export declare function emptyDirectory(targetPath: string): Promise<void>;
 export declare function ensureDirectory(targetPath: string): Promise<void>;
-export declare function copyDirectory(source: string, destination: string): Promise<void>;
+export declare function copyDirectory(source: string, destination: string, renames?: Record<string, string>): Promise<void>;
 export declare function readJsonFile<T = unknown>(filePath: string): Promise<T>;
 export declare function writeJsonFile(filePath: string, data: unknown, spaces?: number): Promise<void>;
 export declare function updatePackageJson(targetPath: string, projectName: string): Promise<void>;

package/dist/file-system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-system.d.ts","sourceRoot":"","sources":["../src/file-system.ts"],"names":[],"mappings":"AAIA,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CAElB;AAED,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAM3E;AAED,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtE;AAED,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvE;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAE5E;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,MAAM,SAAI,GACT,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAQf"}
+{"version":3,"file":"file-system.d.ts","sourceRoot":"","sources":["../src/file-system.ts"],"names":[],"mappings":"AAIA,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CAElB;AAED,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAM3E;AAED,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtE;AAED,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvE;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC,CAef;AAED,wBAAsB,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAE5E;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,MAAM,SAAI,GACT,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/file-system.js

@@ -17,11 +17,21 @@ export async function emptyDirectory(targetPath) {
 export async function ensureDirectory(targetPath) {
     await fs.ensureDir(targetPath);
 }
-export async function copyDirectory(source, destination) {
+export async function copyDirectory(source, destination, renames) {
     if (!(await checkDirectoryExists(source))) {
         throw new Error(MESSAGES.TEMPLATE_NOT_FOUND(source));
     }
     await fs.copy(source, destination);
+    if (renames) {
+        for (const [from, to] of Object.entries(renames)) {
+            const copiedPath = path.join(destination, from);
+            if (fs.existsSync(copiedPath)) {
+                await fs.move(copiedPath, path.join(destination, to), {
+                    overwrite: true,
+                });
+            }
+        }
+    }
 }
 export async function readJsonFile(filePath) {
     return fs.readJson(filePath);

package/dist/package-manager.d.ts

@@ -0,0 +1,5 @@
+export type PackageManager = 'npm' | 'pnpm' | 'yarn' | 'bun';
+/** Detect the package manager that invoked the CLI from npm_config_user_agent
+ *  (e.g. "pnpm/9.12.0 npm/? node/v22 darwin arm64"). Falls back to npm. */
+export declare function detectPackageManager(userAgent?: string | undefined): PackageManager;
+//# sourceMappingURL=package-manager.d.ts.map

package/dist/package-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.d.ts","sourceRoot":"","sources":["../src/package-manager.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAI7D;2EAC2E;AAC3E,wBAAgB,oBAAoB,CAClC,SAAS,GAAE,MAAM,GAAG,SAA6C,GAChE,cAAc,CAKhB"}

package/dist/package-manager.js

@@ -0,0 +1,9 @@
+const KNOWN = ['npm', 'pnpm', 'yarn', 'bun'];
+/** Detect the package manager that invoked the CLI from npm_config_user_agent
+ *  (e.g. "pnpm/9.12.0 npm/? node/v22 darwin arm64"). Falls back to npm. */
+export function detectPackageManager(userAgent = process.env.npm_config_user_agent) {
+    const name = userAgent?.split('/')[0] ?? '';
+    return KNOWN.includes(name)
+        ? name
+        : 'npm';
+}

package/dist/project-creator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-creator.d.ts","sourceRoot":"","sources":["../src/project-creator.ts"],"names":[],"mappings":"AA2BA,OAAO,EAOL,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AAIxB,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAAS;gBAEjB,YAAY,CAAC,EAAE,MAAM;IAI3B,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAa3D,sBAAsB,CAC1B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC;IAkBnB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAInC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjE,oBAAoB,CACxB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAgBV,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC;IAqBV,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAmDhB,OAAO,CAAC,WAAW;IA2BnB,OAAO,CAAC,YAAY;IAYd,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAgJV,mBAAmB,CACvB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAmEV,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAyIvE"}
+{"version":3,"file":"project-creator.d.ts","sourceRoot":"","sources":["../src/project-creator.ts"],"names":[],"mappings":"AA2BA,OAAO,EAOL,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AAWxB,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAAS;gBAEjB,YAAY,CAAC,EAAE,MAAM;IAI3B,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAa3D,sBAAsB,CAC1B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC;IAkBnB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAInC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjE,oBAAoB,CACxB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAgBV,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC;IAqBV,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAmDhB,OAAO,CAAC,WAAW;IA2BnB,OAAO,CAAC,YAAY;IAYd,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAgJV,mBAAmB,CACvB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAmEV,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAyIvE"}

package/dist/project-creator.js

@@ -8,6 +8,12 @@ import { displayHeader, displaySuccess, displayError, displayCancelled, } from '
 import { validateProjectName } from './validators.js';
 import { MESSAGES, ICON_LIBRARIES, BULMA_FLAVORS, CLAUDE_MD, LAUNCH_JSON, CONFIG_PROVIDER_ICON_VALUES, } from './constants.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
+// npm strips literal `.gitignore` files from published tarballs, so the
+// templates track `_gitignore` instead and the scaffolder renames it back
+// on copy — otherwise published scaffolds would ship with no .gitignore.
+const TEMPLATE_RENAMES = {
+    _gitignore: '.gitignore',
+};
 export class ProjectCreator {
     templatesDir;
     constructor(templatesDir) {
@@ -43,7 +49,7 @@ export class ProjectCreator {
     async copyTemplate(template, targetPath) {
         const templatePath = this.getTemplatePath(template);
         await ensureDirectory(targetPath);
-        await copyDirectory(templatePath, targetPath);
+        await copyDirectory(templatePath, targetPath, TEMPLATE_RENAMES);
     }
     async updateIndexHtmlTitle(targetPath, projectName) {
         const indexHtmlPath = path.join(targetPath, 'index.html');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-bestax",
-  "version": "4.0.2",
+  "version": "4.1.1",
   "description": "Create a new bestax-bulma project",
   "type": "module",
   "bin": {
@@ -10,25 +10,6 @@
     "dist",
     "templates"
   ],
-  "scripts": {
-    "build": "node scripts/sync-skills.mjs && tsc",
-    "prepack": "node scripts/sync-skills.mjs",
-    "dev": "tsc --watch",
-    "test": "NODE_OPTIONS=\"--experimental-vm-modules\" jest",
-    "test:watch": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --watch",
-    "test:coverage": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --coverage",
-    "test:e2e": "playwright test --config=e2e/playwright.config.ts",
-    "test:e2e:ui": "playwright test --config=e2e/playwright.config.ts --ui",
-    "test:e2e:headed": "playwright test --config=e2e/playwright.config.ts --headed",
-    "test:e2e:update": "playwright test --config=e2e/playwright.config.ts --update-snapshots",
-    "test:e2e:report": "playwright show-report e2e/playwright-report",
-    "lint": "eslint src e2e/tests e2e/utils",
-    "typecheck": "tsc --noEmit",
-    "format": "prettier --write \"src/**/*.{ts,tsx}\"",
-    "format:check": "prettier --check \"src/**/*.{ts,tsx}\"",
-    "clean": "rimraf dist",
-    "release": "npx semantic-release"
-  },
   "keywords": [
     "bestax",
     "bulma",
@@ -73,7 +54,25 @@
     "wait-on": "^9.1.0"
   },
   "publishConfig": {
-    "access": "public",
-    "provenance": true
-  }
-}
+    "access": "public"
+  },
+  "scripts": {
+    "build": "node scripts/sync-skills.mjs && tsc",
+    "dev": "tsc --watch",
+    "test": "NODE_OPTIONS=\"--experimental-vm-modules\" jest",
+    "test:watch": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --watch",
+    "test:coverage": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --coverage",
+    "test:e2e": "playwright test --config=e2e/playwright.config.ts",
+    "test:e2e:ui": "playwright test --config=e2e/playwright.config.ts --ui",
+    "test:e2e:headed": "playwright test --config=e2e/playwright.config.ts --headed",
+    "test:e2e:update": "playwright test --config=e2e/playwright.config.ts --update-snapshots",
+    "test:e2e:report": "playwright show-report e2e/playwright-report",
+    "lint": "eslint src e2e/tests e2e/utils",
+    "typecheck": "tsc --noEmit",
+    "format": "prettier --write \"src/**/*.{ts,tsx}\"",
+    "format:check": "prettier --check \"src/**/*.{ts,tsx}\"",
+    "clean": "rimraf dist",
+    "release": "npx semantic-release"
+  },
+  "readme": "# create-bestax\n\n[![npm version](https://img.shields.io/npm/v/create-bestax.svg)](https://www.npmjs.com/package/create-bestax)\n[![npm downloads](https://img.shields.io/npm/dm/create-bestax.svg)](https://www.npmjs.com/package/create-bestax)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Socket Badge](https://socket.dev/api/badge/npm/package/create-bestax)](https://socket.dev/npm/package/create-bestax/overview)\n[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/allxsmith/bestax/badge)](https://scorecard.dev/viewer/?uri=github.com/allxsmith/bestax)\n[![npm provenance](https://img.shields.io/badge/npm-provenance-3fb950.svg)](https://www.npmjs.com/package/create-bestax#provenance)\n[![Security policy](https://img.shields.io/badge/security-policy-blue.svg)](https://github.com/allxsmith/bestax/blob/main/SECURITY.md)\n\nThe scaffolder for [`@allxsmith/bestax-bulma`](https://www.npmjs.com/package/@allxsmith/bestax-bulma) — spin up a Vite app pre-wired for the **Bulma v1** React component library in one command. Picks your framework (JS or TypeScript), CSS flavor, and icon library, and can drop in the bestax **AI skills** so an agent like Claude Code knows the library from the first prompt.\n\nPart of the [bestax monorepo](https://github.com/allxsmith/bestax) — see also [`@allxsmith/bestax-bulma`](https://www.npmjs.com/package/@allxsmith/bestax-bulma) for the components themselves.\n\n## Requirements\n\n- **Node.js 22 or newer.** Node 18 and 20 are both past end-of-life. On an older runtime the\n  CLI exits immediately with an explicit upgrade message.\n- npm 10 or newer (ships with Node 22), or yarn/pnpm.\n\n## Usage\n\n### Quick Start\n\n```bash\n# Using npm\nnpm create bestax@latest my-app\n\n# Using npx\nnpx create-bestax@latest my-app\n\n# Alternative naming\nnpm create bestax-bulma@latest my-app\n```\n\n### Interactive Mode\n\nRunning without arguments will prompt you for all options:\n\n```bash\nnpm create bestax@latest\n```\n\nYou'll be asked to:\n\n1. Enter a project name\n2. Select a framework (Vite or Vite + TypeScript)\n3. Choose a Bulma CSS flavor (Complete or Minimal)\n4. Select an icon library (Font Awesome, Material Icons, etc.)\n5. Choose whether to install the bestax AI skills into `.claude/skills/`\n\nEvery prompt has a flag equivalent, so the whole flow is scriptable and CI-friendly — see the options below.\n\n### Command Line Options\n\n```bash\nnpm create bestax@latest [project-directory] [options]\n```\n\n**Arguments:**\n\n- `[project-directory]` - Optional project directory name\n\n**Options:**\n\n- `-t, --template <template>` - Template to use: `vite` or `vite-ts`  \n  **Default:** `vite`\n- `-b, --bulma <flavor>` - Bulma CSS flavor:\n  - `complete` - Full Bulma CSS with all components and helpers\n  - `prefixed` - Prefixed version for compatibility\n  - `no-helpers` - Without helper classes\n  - `no-helpers-prefixed` - Prefixed without helpers\n  - `no-dark-mode` - Without dark mode support  \n    **Default:** `complete`\n- `-i, --icon <library>` - Icon library:\n  - `none` - No icon library\n  - `fontawesome` - Font Awesome\n  - `mdi` - Material Design Icons\n  - `ionicons` - Ionicons\n  - `material-icons` - Material Icons\n  - `material-symbols` - Material Symbols  \n    **Default:** `none`\n- `--skills` / `--no-skills` - Install (or skip) the bestax AI skills into\n  `.claude/skills/` (with a `CLAUDE.md`) so a Claude Code session picks them up\n  automatically. When omitted you're prompted; with `-y` the default is to install.\n- `-y, --yes` - Skip prompts and use defaults or provided options.  \n  When used, the following defaults are selected unless overridden by flags:\n  - Template: `vite`\n  - Bulma flavor: `complete`\n  - Icon library: `none`\n  - AI skills: installed (pass `--no-skills` to opt out)\n\n**Example:**\n\n```bash\n# Create a TypeScript project with Font Awesome icons\nnpm create bestax@latest my-app -t vite-ts -i fontawesome -b complete\n\n# Use all defaults (skip prompts)\nnpm create bestax@latest my-app -y\n```\n\n## Templates\n\nAvailable templates:\n\n- `vite` - Vite + JavaScript\n- `vite-ts` - Vite + TypeScript\n\nEach template includes:\n\n- Pre-configured bestax-bulma integration (React 19)\n- The latest `@allxsmith/bestax-bulma`, which ships Bulma v1 automatically\n- Icon library support (Font Awesome, Material Design, etc.)\n- Sample components demonstrating library usage\n- Development and build scripts\n\n## For AI Tools\n\nScaffolding for an AI agent? Pass `--skills` (or accept the prompt) to drop the bestax\nAgent Skills and a `CLAUDE.md` into the new project so Claude Code, Cursor, or Copilot\nbuild the bestax way from the start. The library also ships LLM-optimized docs:\n\n- [LLMs guide](https://bestax.io/docs/guides/llms) — using bestax with Claude Code, Cursor, Copilot\n- [Agent Skills](https://bestax.io/docs/skills/intro) — teach your agent the bestax conventions\n- [llms.txt](https://bestax.io/llms.txt) (curated index) · [llms-full.txt](https://bestax.io/llms-full.txt) (full docs)\n\n## Development\n\n```bash\nnpm run build    # Build the CLI\nnpm run dev      # Watch mode\nnpm test         # Run tests\nnpm run lint     # Lint CLI source code\nnpm run typecheck # Type check CLI source code\n```\n\n**Note on Templates:** Template files in `templates/` are excluded from linting. They should be manually validated by scaffolding a test project and running lint/build there before releasing.\n\n## Hardened by default\n\nA scaffolder runs with write access to your filesystem and picks your starting dependencies, so how it is built and published matters:\n\n- **Signed provenance** — every release carries a sigstore attestation linking the tarball to the exact commit and CI run that built it. Check the **Provenance** section on the [npm page](https://www.npmjs.com/package/create-bestax#provenance), or run `npm audit signatures`.\n- **npm OIDC trusted publishing** — short-lived, per-run credentials; no long-lived `NPM_TOKEN` exists to be stolen. Release commits and tags are GPG-signed.\n- **Socket.dev scans every PR** for malware, install scripts, obfuscated code, and privilege escalation before it can reach `main`.\n- **Dependencies are a deliberate act** — install scripts are blocked unless individually allow-listed, freshly published versions are refused for 3 days, and CI installs only what the reviewed lockfile resolves.\n- **Every GitHub Action is pinned to a full commit SHA**, so a compromised action release can't roll silently into a build of this CLI.\n- **CodeQL, Dependency Review, and Dependabot** run continuously, alongside a high-severity `pnpm audit` gate.\n- **Layered AI review before merge** — [CodeRabbit](https://coderabbit.ai) plus an independent adversarial Claude review (a different model from the one writing AI-authored changes), on top of required green CI, an approving review, and a human merge.\n\nFull detail: [`SECURITY.md`](https://github.com/allxsmith/bestax/blob/main/SECURITY.md) · [Security guide](https://bestax.io/docs/guides/security)\n\n## Publishing\n\nThis package uses semantic-release with scope-based rules. Only commits with `feat(create-bestax)` or `fix(create-bestax)` will trigger releases.\n"
+}

package/templates/skills/bestax-custom-component/SKILL.md

@@ -50,11 +50,12 @@ label — use that instead"_ or _"No `ProfileCard` exists; I'll build one compos
 
 Build from existing components before writing any CSS: `Box`, `Card`, `Title`, `SubTitle`,
 `Icon`, `Block`, `Content`, `Tag`, plus the shared Bulma helper props (spacing, color,
-typography, flexbox). Compound sub-parts are the exception — `Card.Content`, `Modal.Card`,
-`Tabs.Tab`, `Message.Body` take **no Bulma helper props**, just `className` + HTML attributes
+typography, flexbox). Some compound sub-parts are the exception — `Modal.Card`, `Tabs.Tab`,
+`Message.Body` take **no Bulma helper props**, just `className` + HTML attributes
 plus their own few (`Tabs.Tab` requires `index={i}` and has built-in `disabled` and
 `icon`/`iconLibrary`/`iconVariant`/`iconSize`/`iconFeatures` — don't nest an `<Icon>` there) —
-so put helper props on the parent or on an element inside them, never invent them there. Most "custom components" are a composition function — zero new styles.
+so put helper props on the parent or on an element inside them, never invent them there.
+(`Card.*` sub-parts do take helper props, like `Table.*`/`Menu.*`/`Hero.*`.) Most "custom components" are a composition function — zero new styles.
 See `examples/stat-card.tsx` for a complete worked example.
 
 ## The component spine

package/templates/skills/bestax-custom-component/references/api.md

@@ -12,11 +12,23 @@ Everything below is public API. Where to import from depends on your context:
 Turns Bulma helper props into a class string and returns the leftover (non-helper) props.
 
 ```ts
-const { bulmaHelperClasses, rest } = useBulmaClasses(props);
+const { bulmaHelperClasses, bulmaHelperStyles, rest } = useBulmaClasses(props);
 // bulmaHelperClasses: e.g. 'has-text-primary is-size-3 m-3'
-// rest: every prop that was NOT a recognized helper (safe to spread on the DOM)
+// bulmaHelperStyles: inline styles for scheme-aware values, or undefined (see below)
+// rest: every prop that was NOT a recognized helper; destructure your own
+// component props and `style` before spreading it on a DOM element
 ```
 
+`bulmaHelperStyles` is `undefined` unless `backgroundColor` is one of the six
+`validSchemeColors` values (`scheme-main`, `scheme-main-bis`, `scheme-main-ter`,
+`scheme-invert`, `scheme-invert-bis`, `scheme-invert-ter`). Bulma ships no
+`has-background-scheme-*` classes, so those values emit no class; the hook returns
+`{ backgroundColor: 'var(--bulma-<value>)' }` instead — a dark-mode-safe inline style. Put it
+on the root element with `mergeBulmaStyles(bulmaHelperStyles, style)`
+(`helpers/mergeBulmaStyles.ts`): the user's `style` prop wins on conflicts, and the result is
+`undefined` when both are absent so unaffected components keep an attribute-free DOM.
+(`useColorStyles` is the underlying per-concern hook.)
+
 `BulmaClassesProps` is the union of all helper prop groups, composed from per-concern hooks
 that can also be used on their own:
 
@@ -31,9 +43,10 @@ that can also be used on their own:
 
 Because the component destructures these into `bulmaHelperClasses`, callers get the full Bulma
 helper surface for free on every component built this way, and `rest` stays clean for DOM
-spreading. (Library compound sub-parts — `Card.Content`, `Modal.Card`, `Tabs.Tab`,
+spreading. (Some library compound sub-parts — `Modal.Card`, `Tabs.Tab`,
 `Message.Body` — do **not** take helper props: just `className`, HTML attributes, and their own
-few, e.g. `Tabs.Tab`'s required `index` and its built-in `icon`/`disabled` props.)
+few, e.g. `Tabs.Tab`'s required `index` and its built-in `icon`/`disabled` props. `Card.*`
+sub-parts do take them.)
 
 ## `classNames(...)` and friends — `helpers/classNames.ts`
 
@@ -55,16 +68,22 @@ de-dupes. Related exports:
 Re-exported through `useBulmaClasses`. Use them to type component-specific props and to drive
 Storybook `argTypes`/tests:
 
-`validColors`, `validColorShades`, `validSizes`, `validTextSizes`, `validAlignments`,
-`validTextTransforms`, `validTextWeights`, `validFontFamilies`, `validDisplays`,
-`validVisibilities`, `validFlexDirections`, `validFlexWraps`, `validJustifyContents`,
-`validAlignContents`, `validAlignItems`, `validAlignSelfs`, `validFlexGrowShrink`,
-`validViewports`.
+`validColors`, `validColorShades`, `validSchemeColors`, `validSizes`, `validTextSizes`,
+`validAlignments`, `validTextTransforms`, `validTextWeights`, `validFontFamilies`,
+`validDisplays`, `validVisibilities`, `validFlexDirections`, `validFlexWraps`,
+`validJustifyContents`, `validAlignContents`, `validAlignItems`, `validAlignSelfs`,
+`validFlexGrowShrink`, `validViewports`.
 
 ```ts
 export type MyColor = (typeof validColors)[number];
 ```
 
+`validSchemeColors` is the scheme-background tuple consumed by `bulmaHelperStyles` (above).
+Components that support scheme backgrounds widen their own `bgColor` union with
+`(typeof validSchemeColors)[number]` — the widening is deliberate and per-component, so a
+component that has not wired `bulmaHelperStyles` onto its root element must keep the narrow
+union (a compile error beats a silent no-op).
+
 ## `ConfigProvider` / `Theme` — `helpers/Config.tsx`, `helpers/Theme.tsx`
 
 `ConfigProvider` provides the runtime `classPrefix` (and `iconLibrary`) consumed via `useConfig`;

package/templates/skills/bestax-custom-component/references/component-catalog.md

@@ -24,8 +24,8 @@ instead of hand-writing markup.
 - **Compound components** expose sub-parts via dot access (e.g. `Card.Header`,
   `Navbar.Item`, `Tabs.Tab`, `Hero.Body`, `Columns.Column`, `Table.Tr`); see the
   component's linked page for the full set. Sub-parts do **not** all take helper
-  props: the `Table.*`, `Menu.*`, and `Hero.*` families do (most `Navbar.*`
-  too), but `Card.*`, `Modal.*`, `Tabs.*`, and `Message.*` sub-parts take none —
+  props: the `Card.*`, `Table.*`, `Menu.*`, and `Hero.*` families do (most
+  `Navbar.*` too), but `Modal.*`, `Tabs.*`, and `Message.*` sub-parts take none —
   just `className`, HTML attributes, and their own few (`Tabs.Tab` requires
   `index` and has built-in `icon`/`disabled` props). Put helper props on the
   parent or on an element inside (`Span`, `Paragraph`, …) instead.
@@ -143,7 +143,7 @@ component is guaranteed to appear (the generator fails if one lacks an API page)
 
 - [ConfigProvider](https://bestax.io/docs/api/helpers/config) — The `ConfigProvider` component provides a React context for configuring global settings across all Bulma UI components.
 - [Theme](https://bestax.io/docs/api/helpers/theme) — The `Theme` component provides a powerful way to customize Bulma's appearance using CSS custom properties (CSS variables).
-- [Valid value constants](https://bestax.io/docs/api/helpers/valid-values) — The `valid*` constant arrays enumerate every accepted value for the shared Bulma helper props — public API you can import to build prop types and validation.
+- [Valid value constants](https://bestax.io/docs/api/helpers/valid-values) — The `valid*` tuples enumerate the core accepted values for the shared Bulma helper props — public API for building prop types and validation.
 - [classNames](https://bestax.io/docs/api/helpers/classnames) — `classNames` is a utility function for conditionally joining class names together.
 - [useBulmaClasses](https://bestax.io/docs/api/helpers/usebulmaclasses) — `useBulmaClasses` is a custom React hook that generates Bulma helper class strings from a set of props.
 - [usePrefixedClassNames](https://bestax.io/docs/api/helpers/useprefixedclassnames) — `usePrefixedClassNames` builds a component class string that honors the `classPrefix` from `ConfigProvider` — the hook every bestax component uses for its own…

package/templates/skills/bestax-form/SKILL.md

@@ -96,6 +96,9 @@ All import from `@allxsmith/bestax-bulma`. Convenience components auto-wrap Fiel
 | `Taginput`                                              | Tag/chip input; suggestions, confirm keys, closable tags.                 |
 | `DateInput` / `TimeInput` / `DateTimeInput` (+ `*Base`) | Date / time / datetime pickers.                                           |
 
+(`NumberInput` and `TagInput` also exist as deprecated aliases of `Numberinput`/`Taginput` —
+same components; prefer the lowercase-second-word spellings.)
+
 ## Common props
 
 Across the convenience inputs (`Input`, `Select`, `TextArea`, and similar):
@@ -116,8 +119,10 @@ Across the convenience inputs (`Input`, `Select`, `TextArea`, and similar):
 Plus the full Bulma **helper props** (`m`, `p`, `textColor`, `display`, …) on every component
 via `useBulmaClasses`.
 
-⚠️ Full-width casing is inconsistent across the library: `Select`, `File`, and `Table` take
-`isFullwidth` (lowercase w); `Button` alone takes `isFullWidth`; `Tabs` takes bare `fullwidth`.
+Full-width is `isFullwidth` on every component that supports it (`Button`, `LinkButton`,
+`Select`, `File`, `Table`, `Tabs`, `Sidebar`) — always write `isFullwidth`. The deprecated
+spellings compile only where they historically existed: `isFullWidth` everywhere except
+`Sidebar`, `fullwidth` on `Tabs` only, `fullWidth` on `Sidebar` only.
 
 The `label` prop on the single-control convenience inputs (`Input`, `Select`, `TextArea`,
 `File`, `Numberinput`, `Slider`, `DateInput`, `TimeInput`, `DateTimeInput`, `Autocomplete`,

package/templates/skills/bestax-form/references/api.md

@@ -59,7 +59,7 @@ Wraps a single input; adds icons and loading.
 ## Select / SelectBase, TextArea / TextAreaBase
 
 Same convenience/raw split as Input. `Select` supports `isLoading` (on the control), `color`,
-`size`, `isRounded`, `isFullwidth` (lowercase w — Button's is `isFullWidth`), `multiple` +
+`size`, `isRounded`, `isFullwidth`, `multiple` +
 `multipleSize`, plus the Field/Control/message props. `TextArea` adds `rows` and
 `hasFixedSize`.
 

package/templates/skills/bestax-layout-scaffold/SKILL.md

@@ -70,10 +70,15 @@ Centered; a collection of items → Card grid. For mixed requests, pick the domi
   `textWeight`, `textSize` directly (their `color` prop colors the cell; for muted cell text
   wrap content in `Span textColor="grey"`). Set the app-wide icon library once with
   `<ConfigProvider iconLibrary="…">` at the root rather than `library` on every `<Icon>`.
-- **Decorative CSS is budgeted: three compact rules, ≤13 lines per app — comments count:
+- **Alternating section bands are a prop, not CSS: `bgColor="scheme-main-bis"` on every
+  other `Section` (next band `scheme-main-ter`).** The scheme values render as a
+  dark-mode-safe inline `background-color: var(--bulma-scheme-*)` — zero custom CSS — and
+  still never `bgColor="light"`/`"white"`: those are fixed colors that stay light when dark
+  mode flips the text.
+- **Decorative CSS is budgeted: two compact rules, ≤10 lines per app — comments count:
   at most one short inline note, never a file-header comment block — every value derived
-  from `--bulma-*`.** A marketing page gets at most one hero wash, one alternating section
-  band, and one featured-card ring, applied via `className` — no resets (Bulma ships one;
+  from `--bulma-*`.** A marketing page gets at most one hero wash and one featured-card
+  ring, applied via `className` — no resets (Bulma ships one;
   body/list margins are already zero) and no grid textures, masks, or multi-layer backdrops;
   the components carry the design:
 
@@ -85,9 +90,6 @@ Centered; a collection of items → Card grid. For mixed requests, pick the domi
       transparent 60%
     );
   }
-  .section-alt {
-    background: var(--bulma-scheme-main-bis); /* next band: -ter */
-  }
   .featured-ring {
     --bulma-shadow: 0 0 0 2px var(--bulma-primary);
   }
@@ -188,8 +190,10 @@ inline `style`.
 - [ ] Style with helper props, not inline `style` — translate via the mapping table; values
       with no helper get a named class in the stylesheet, never `style={{}}`. No raw Bulma
       `className`s either (`Span`/`Paragraph` wrap bare text; `Th`/`Td` take `textAlign`/`textWeight`).
-- [ ] Decorative CSS ≤13 lines total incl. comments — no file-header comment (hero wash +
-      section band + featured-card ring), `--bulma-*`-derived; no resets — Bulma ships one.
+- [ ] Alternating bands are `bgColor="scheme-main-bis"` (next band `scheme-main-ter`) on
+      every other `Section` — never band CSS, never `bgColor="light"`/`"white"`.
+- [ ] Decorative CSS ≤10 lines total incl. comments — no file-header comment (hero wash +
+      featured-card ring), `--bulma-*`-derived; no resets — Bulma ships one.
       The ring sets `--bulma-shadow` in a CSS rule; `Theme bulmaVars` has no such key.
 - [ ] Set the icon library once via `<ConfigProvider iconLibrary="…">` at the root.
 - [ ] Site built? ~800 KB raw / ~82 KB gzip CSS is the expected default-flavor size — to shrink

package/templates/skills/bestax-layout-scaffold/examples/centered.tsx

@@ -44,7 +44,7 @@ export default function LoginPage() {
                 iconLeftName="lock"
                 placeholder="••••••••"
               />
-              <Button color="primary" isFullWidth mt="4">
+              <Button color="primary" isFullwidth mt="4">
                 Sign in
               </Button>
             </Box>

package/templates/skills/bestax-layout-scaffold/references/archetypes.md

@@ -155,8 +155,11 @@ the `Hero`; if it's `fixed="top"`, the same `<html class="has-navbar-fixed-top">
 applies here too.
 
 **Alternating section bands:** tint every other `Section` with a scheme step —
-`.section-alt { background: var(--bulma-scheme-main-bis); }` (next step `-ter`) — not
-`bgColor="light"`/`"white"`: those are fixed colors that stay light when dark mode flips the text.
+`bgColor="scheme-main-bis"` (next step `scheme-main-ter`) — not `bgColor="light"`/`"white"`:
+those are fixed colors that stay light when dark mode flips the text. Scheme values emit no
+class; the component renders a dark-mode-safe inline `background-color: var(--bulma-scheme-*)`
+style, so bands cost zero custom CSS. The same values work on `Hero` (and its
+`Head`/`Body`/`Foot`), `Footer`, `Container`, `Box`, and `Card`.
 
 **Hero CTAs:** on a colored hero use **filled** buttons only — `color="light"` for the primary
 CTA and `color="primary" isInverted` (solid white, primary text) for a secondary. A thin

package/templates/skills/bestax-layout-scaffold/references/layout-components.md

@@ -118,6 +118,18 @@ The responsive grid. `Columns` is the row; `Column` is a cell (also reachable as
 ```ts
 type BulmaColumnSize =
   | number // 1–12
+  | '1'
+  | '2'
+  | '3'
+  | '4'
+  | '5'
+  | '6'
+  | '7'
+  | '8'
+  | '9'
+  | '10'
+  | '11'
+  | '12' // string form, equivalent
   | 'full'
   | 'half'
   | 'one-third'
@@ -130,8 +142,8 @@ type BulmaColumnSize =
   | 'four-fifths';
 ```
 
-Numeric sizes are **numbers** — `sizeDesktop={7}`, never `"7"`; only the fraction names are
-strings. (`gap` is the exception that accepts number **or** string.)
+Numeric sizes accept a number **or** its string form — `sizeDesktop={7}` and
+`sizeDesktop="7"` are equivalent, and the fraction names are strings.
 
 > Columns **stack on mobile** by default and go side-by-side at the tablet breakpoint and up.
 > Use the per-breakpoint `size*` props to control how many cells share a row at each width.
@@ -157,7 +169,9 @@ the column's auto height). Make the `Column` a flex container and let the card g
 ```
 
 `display`, `flexDirection`, and `flexGrow` are helper props every component accepts;
-`flexGrow` takes a string (`"1"`).
+`flexGrow` takes a string (`"1"`). `Card.*` sub-parts accept helper props too, so pinning a
+footer inside a card is `<Card display="flex" flexDirection="column">` +
+`<Card.Content flexGrow="1">` — no `Box` swap needed.
 
 ## Grid / Cell
 

package/templates/skills/bestax-migrate/references/prop-map.md

@@ -32,7 +32,7 @@ this automatically for literal values; dynamic values get TODOs.
 ## Boolean modifier convention
 
 RBC uses bare booleans (`loading`, `outlined`, `rounded`, `fullwidth`); bestax prefixes
-with `is`/`has` (`isLoading`, `isOutlined`, `isRounded`, `isFullWidth`). Per-component
+with `is`/`has` (`isLoading`, `isOutlined`, `isRounded`, `isFullwidth`). Per-component
 tables live in [component-map.md](component-map.md).
 
 ## Responsive breakpoint objects → flat per-viewport props

package/templates/skills/bestax-theming/SKILL.md

@@ -44,9 +44,13 @@ color tokens or fixed-color surfaces exist:
   (`--my-canvas: var(--bulma-scheme-main)`) — or flip them yourself under **both** dark-mode
   paths: `[data-theme='dark']` **and** `@media (prefers-color-scheme: dark)` scoped to
   `:root:not([data-theme])`, since `colorMode="system"` removes the attribute (snippets in
-  `references/css-variables.md`). Alternating/tinted section bands are this case:
-  `background: var(--bulma-scheme-main-bis)` (then `-ter`), never `bgColor="light"` —
-  `light`/`white`/grey helper backgrounds are fixed colors that fight dark mode.
+  `references/css-variables.md`). Alternating/tinted section bands are first-class props:
+  `bgColor="scheme-main-bis"` (then `"scheme-main-ter"`) on `Section` (also `Hero`, `Footer`,
+  `Container`, `Box`, `Card`) renders a scheme-tracking inline background — never
+  `bgColor="light"`: `light`/`white`/grey helper backgrounds are fixed colors that fight
+  dark mode. Keep the derive-from-scheme-vars CSS for other custom surfaces. `Theme
+bulmaVars` now accepts `--bulma-scheme-main`/`-bis`/`-ter` (and the `-invert` trio)
+  overrides, so one Theme re-tints every band at once.
 - **Fixed-color surface → fixed-color content.** On a surface that never changes (a dark hero,
   a brand banner), pin the content's colors too: solid/filled buttons and explicit text colors,
   never scheme-derived defaults or thin outlines that depend on the flipping scheme.

package/templates/skills/bestax-theming/references/css-variables.md

@@ -81,13 +81,14 @@ and numeric shades `--bulma-<c>-00` … `--bulma-<c>-95`.
 
 ## Scheme, text, background, border (light/dark surfaces)
 
-| Variable                                                                    | Role                                                  |
-| --------------------------------------------------------------------------- | ----------------------------------------------------- |
-| `--bulma-scheme-h`, `--bulma-scheme-s`                                      | scheme hue/saturation (`Theme`: `schemeH`, `schemeS`) |
-| `--bulma-scheme-main`, `--bulma-scheme-main-bis`, `--bulma-scheme-main-ter` | page/surface backgrounds (main + subtle steps)        |
-| `--bulma-background`                                                        | secondary background                                  |
-| `--bulma-text`, `--bulma-text-strong`, `--bulma-text-weak`                  | body / emphasized / muted text                        |
-| `--bulma-border`, `--bulma-border-weak`                                     | borders                                               |
+| Variable                                                                          | Role                                                                                                                                                       |
+| --------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `--bulma-scheme-h`, `--bulma-scheme-s`                                            | scheme hue/saturation (`Theme`: `schemeH`, `schemeS`)                                                                                                      |
+| `--bulma-scheme-main`, `--bulma-scheme-main-bis`, `--bulma-scheme-main-ter`       | page/surface backgrounds (main + subtle steps); `Theme bulmaVars`-overridable, and the scheme `bgColor` values render them inline                          |
+| `--bulma-scheme-invert`, `--bulma-scheme-invert-bis`, `--bulma-scheme-invert-ter` | inverted scheme surfaces; `Theme bulmaVars`-overridable, and the scheme `bgColor` values render them inline (pair with a foreground — see the color guide) |
+| `--bulma-background`                                                              | secondary background                                                                                                                                       |
+| `--bulma-text`, `--bulma-text-strong`, `--bulma-text-weak`                        | body / emphasized / muted text                                                                                                                             |
+| `--bulma-border`, `--bulma-border-weak`                                           | borders                                                                                                                                                    |
 
 ## Radius, typography
 

package/templates/skills/bestax-theming/references/themeable-components.md

@@ -50,14 +50,14 @@ Shades (`colorShade` / `backgroundColorShade`): `00, 05, 10, … 95, invert, lig
 | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `Button`           | `primary \| link \| info \| success \| warning \| danger \| white \| light \| dark \| black \| text \| ghost`                                                | `small \| normal \| medium \| large`                                      | adds `text`, `ghost`; also `isLight`, `isOutlined`, `isInverted`, `isRounded`                                                                       |
 | `Notification`     | the 17 `validColors` (`black-bis`, `black-ter`, and greys deprecated: no CSS, dev-warn, removed next major — see ⚠️)                                         | —                                                                         | also `isLight`                                                                                                                                      |
-| `Tag`              | `primary \| link \| info \| success \| warning \| danger \| black \| dark \| light \| white`                                                                 | `normal \| medium \| large`                                               | also `isRounded`, `isDelete`, `isHoverable` — **no `isLight`**                                                                                      |
+| `Tag`              | `primary \| link \| info \| success \| warning \| danger \| black \| dark \| light \| white`                                                                 | `normal \| medium \| large`                                               | also `isLight`, `isRounded`, `isDelete`, `isHoverable`                                                                                              |
 | `Box`              | `primary \| link \| info \| success \| warning \| danger`                                                                                                    | —                                                                         | `color` renders `has-text-<color>`, same as `textColor` (which wins when both are set; no `.box.is-*` ships — tint via `bgColor`); also `hasShadow` |
 | `Message`          | `primary \| link \| info \| success \| warning \| danger`                                                                                                    | —                                                                         | the 6 only                                                                                                                                          |
 | `Input`            | `primary \| link \| info \| success \| warning \| danger \| black \| dark \| light \| white`                                                                 | `small \| medium \| large`                                                | also `isRounded`, `isStatic`                                                                                                                        |
 | `Avatar`           | `primary \| link \| info \| success \| warning \| danger \| black \| dark \| light \| white`                                                                 | `16x16 \| 24x24 \| 32x32 \| 48x48 \| 64x64 \| 96x96 \| 128x128 \| number` | initials/icon background (auto-derived from `name` when unset); also `shape`                                                                        |
 | `Badge`            | `primary \| link \| info \| success \| warning \| danger \| black \| dark \| light \| white`                                                                 | —                                                                         | pill background; default `danger`                                                                                                                   |
-| `Title`            | — (no `color`; use `textColor`)                                                                                                                              | `1 \| 2 \| 3 \| 4 \| 5 \| 6`                                              | also `isSpaced`                                                                                                                                     |
-| `SubTitle`         | — (no `color`; use `textColor`)                                                                                                                              | `1 \| 2 \| 3 \| 4 \| 5 \| 6`                                              | —                                                                                                                                                   |
+| `Title`            | — (no `color`; use `textColor`)                                                                                                                              | `1`–`6` (string or number)                                                | also `isSpaced`                                                                                                                                     |
+| `SubTitle`         | — (no `color`; use `textColor`)                                                                                                                              | `1`–`6` (string or number)                                                | —                                                                                                                                                   |
 | `Autocomplete`     | `primary \| link \| info \| success \| warning \| danger`                                                                                                    | `small \| medium \| large`                                                | the 6 only                                                                                                                                          |
 | `Checkbox`         | `primary \| link \| info \| success \| warning \| danger`                                                                                                    | `small \| normal \| medium \| large`                                      | the 6 only                                                                                                                                          |
 | `DateInput`        | `primary \| link \| info \| success \| warning \| danger`                                                                                                    | `small \| medium \| large`                                                | also `isRounded`                                                                                                                                    |

package/templates/vite/_gitignore

@@ -0,0 +1,25 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+*.tsbuildinfo
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?

package/templates/vite-ts/_gitignore

@@ -0,0 +1,25 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+*.tsbuildinfo
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?

package/templates/vite-ts/tsconfig.json

@@ -5,6 +5,7 @@
     "lib": ["ES2020", "DOM", "DOM.Iterable"],
     "module": "ESNext",
     "skipLibCheck": true,
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.tsbuildinfo",
 
     /* Bundler mode */
     "moduleResolution": "bundler",