create-absolutejs 0.13.7 → 0.13.9

package/dist/generators/angular/generateAngularPage.d.ts

@@ -1,6 +1,6 @@
 import { Frontend } from '../../types';
-export declare const generateAngularPage: (_frontends: Frontend[]) => string;
-export declare const generateAngularPageHtml: () => string;
+export declare const generateAngularPage: (_frontends: Frontend[], includeExamples: boolean) => "import { Component } from '@angular/core';\nimport { CommonModule } from '@angular/common';\nimport { defineAngularPage } from '@absolutejs/absolute/angular';\n\ntype AngularPageProps = {\n\tinitialCount: number;\n};\n\n@Component({\n\timports: [CommonModule],\n\tselector: 'angular-page',\n\tstandalone: true,\n\ttemplateUrl: '../templates/angular-example.html'\n})\nexport class AngularExampleComponent {}\n\nexport const page = defineAngularPage<AngularPageProps>({\n\tcomponent: AngularExampleComponent\n});\n" | "import { Component, inject, InjectionToken } from '@angular/core';\nimport { CommonModule } from '@angular/common';\nimport { defineAngularPage } from '@absolutejs/absolute/angular';\nimport { DropdownComponent } from '../components/dropdown.component';\nimport { AppComponent } from '../components/app.component';\n\nexport const INITIAL_COUNT = new InjectionToken<number>('INITIAL_COUNT');\n\ntype AngularPageProps = {\n\tinitialCount: number;\n};\n\n@Component({\n\timports: [CommonModule, DropdownComponent, AppComponent],\n\tselector: 'angular-page',\n\tstandalone: true,\n\ttemplateUrl: '../templates/angular-example.html'\n})\nexport class AngularExampleComponent {\n\tinitialCount: number = 0;\n\n\tconstructor() {\n\t\tconst initialCountToken = inject(INITIAL_COUNT, { optional: true });\n\t\tthis.initialCount = initialCountToken ?? 0;\n\t}\n}\n\nexport const page = defineAngularPage<AngularPageProps>({\n\tcomponent: AngularExampleComponent\n});\n";
+export declare const generateAngularPageHtml: (includeExamples: boolean) => "<main></main>\n" | "<header>\n\t<a href=\"/\">AbsoluteJS</a>\n\t<app-dropdown></app-dropdown>\n</header>\n<app-root [initialCount]=\"initialCount\"></app-root>\n";
 export declare const generateAppComponent: (isSingleFrontend: boolean) => string;
 export declare const generateAppComponentCss: () => string;
 export declare const generateAppComponentHtml: (frontends: Frontend[], editBasePath: string) => string;

package/dist/generators/angular/generateAngularPage.js

@@ -1,6 +1,28 @@
 import { formatNavLink } from '../../utils/formatNavLink';
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
-export const generateAngularPage = (_frontends) => `import { Component, inject, InjectionToken } from '@angular/core';
+export const generateAngularPage = (_frontends, includeExamples) => {
+    if (!includeExamples)
+        return `import { Component } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { defineAngularPage } from '@absolutejs/absolute/angular';
+
+type AngularPageProps = {
+	initialCount: number;
+};
+
+@Component({
+	imports: [CommonModule],
+	selector: 'angular-page',
+	standalone: true,
+	templateUrl: '../templates/angular-example.html'
+})
+export class AngularExampleComponent {}
+
+export const page = defineAngularPage<AngularPageProps>({
+	component: AngularExampleComponent
+});
+`;
+    return `import { Component, inject, InjectionToken } from '@angular/core';
 import { CommonModule } from '@angular/common';
 import { defineAngularPage } from '@absolutejs/absolute/angular';
 import { DropdownComponent } from '../components/dropdown.component';
@@ -31,12 +53,17 @@ export const page = defineAngularPage<AngularPageProps>({
 	component: AngularExampleComponent
 });
 `;
-export const generateAngularPageHtml = () => `<header>
+};
+export const generateAngularPageHtml = (includeExamples) => {
+    if (!includeExamples)
+        return `<main></main>\n`;
+    return `<header>
 	<a href="/">AbsoluteJS</a>
 	<app-dropdown></app-dropdown>
 </header>
 <app-root [initialCount]="initialCount"></app-root>
 `;
+};
 export const generateAppComponent = (isSingleFrontend) => `import { Component, Input, ViewEncapsulation } from '@angular/core';
 import { CommonModule } from '@angular/common';
 import { CounterComponent } from './counter.component';

package/dist/generators/angular/scaffoldAngular.d.ts

@@ -1,2 +1,2 @@
 import { ScaffoldFrontendProps } from '../../types';
-export declare const scaffoldAngular: ({ editBasePath, isSingleFrontend, targetDirectory, frontends, templatesDirectory, projectAssetsDirectory, stylesDirectory, stylesIndexesDirectory }: ScaffoldFrontendProps) => void;
+export declare const scaffoldAngular: ({ editBasePath, includeExamples, isSingleFrontend, targetDirectory, frontends, templatesDirectory, projectAssetsDirectory, stylesDirectory, stylesIndexesDirectory }: ScaffoldFrontendProps) => void;

package/dist/generators/angular/scaffoldAngular.js

@@ -2,16 +2,24 @@ import { copyFileSync, mkdirSync, writeFileSync } from 'fs';
 import { join } from 'path';
 import { generateMarkupCSS } from '../project/generateMarkupCSS';
 import { generateAngularPage, generateAngularPageHtml, generateAppComponent, generateAppComponentCss, generateAppComponentHtml, generateCounterComponent, generateCounterComponentCss, generateCounterComponentHtml, generateDropdownComponent, generateDropdownComponentHtml } from './generateAngularPage';
-export const scaffoldAngular = ({ editBasePath, isSingleFrontend, targetDirectory, frontends, templatesDirectory, projectAssetsDirectory, stylesDirectory, stylesIndexesDirectory }) => {
+export const scaffoldAngular = ({ editBasePath, includeExamples, isSingleFrontend, targetDirectory, frontends, templatesDirectory, projectAssetsDirectory, stylesDirectory, stylesIndexesDirectory }) => {
+    const pagesDirectory = join(targetDirectory, 'pages');
+    const templatesDir = join(targetDirectory, 'templates');
+    if (!includeExamples) {
+        mkdirSync(pagesDirectory, { recursive: true });
+        mkdirSync(templatesDir, { recursive: true });
+        writeFileSync(join(pagesDirectory, 'angular-example.ts'), generateAngularPage(frontends, false), 'utf-8');
+        writeFileSync(join(templatesDir, 'angular-example.html'), generateAngularPageHtml(false), 'utf-8');
+        writeFileSync(join(stylesIndexesDirectory, 'angular-example.css'), `@import url('../reset.css');\n\nangular-page {\n\tdisplay: flex;\n\tflex: 1;\n\tflex-direction: column;\n}\n`, 'utf-8');
+        return;
+    }
     copyFileSync(join(templatesDirectory, 'assets', 'svg', 'angular.svg'), join(projectAssetsDirectory, 'svg', 'angular.svg'));
     const componentsDirectory = join(targetDirectory, 'components');
     mkdirSync(componentsDirectory, { recursive: true });
-    const pagesDirectory = join(targetDirectory, 'pages');
     mkdirSync(pagesDirectory, { recursive: true });
-    const templatesDir = join(targetDirectory, 'templates');
     mkdirSync(templatesDir, { recursive: true });
-    writeFileSync(join(pagesDirectory, 'angular-example.ts'), generateAngularPage(frontends), 'utf-8');
-    writeFileSync(join(templatesDir, 'angular-example.html'), generateAngularPageHtml(), 'utf-8');
+    writeFileSync(join(pagesDirectory, 'angular-example.ts'), generateAngularPage(frontends, true), 'utf-8');
+    writeFileSync(join(templatesDir, 'angular-example.html'), generateAngularPageHtml(true), 'utf-8');
     writeFileSync(join(componentsDirectory, 'dropdown.component.ts'), generateDropdownComponent(frontends), 'utf-8');
     writeFileSync(join(templatesDir, 'dropdown.component.html'), generateDropdownComponentHtml(frontends), 'utf-8');
     writeFileSync(join(componentsDirectory, 'app.component.ts'), generateAppComponent(isSingleFrontend), 'utf-8');

package/dist/generators/db/scaffoldDatabase.js

@@ -1,6 +1,5 @@
 import { mkdirSync, writeFileSync } from 'fs';
 import { join } from 'path';
-import { $ } from 'bun';
 import { dim, yellow } from 'picocolors';
 import { isDrizzleDialect } from '../../typeGuards';
 import { checkSqliteInstalled } from '../../utils/checkSqliteInstalled';
@@ -52,11 +51,18 @@ export const scaffoldDatabase = async ({ projectName, databaseEngine, databaseHo
         writeFileSync(join(projectDatabaseDirectory, 'schema.sql'), generateRelationalSchema(databaseEngine, authOption));
     }
     if (databaseEngine === 'sqlite') {
+        // The sqlite3 CLI is a developer convenience (a db shell), never a
+        // scaffold requirement — seeding goes through bun:sqlite below, which
+        // ships with the runtime. The check only nudges interactive users;
+        // headless runs (the Studio container, CI) skip it entirely.
         void ((orm === undefined || orm === 'none') &&
             (await checkSqliteInstalled()));
         const sqliteSchema = generateSqliteSchema(authOption);
         writeFileSync(join(projectDatabaseDirectory, 'schema.sql'), sqliteSchema);
-        await $ `sqlite3 ${databaseDirectory}/database.sqlite ".read ${join(databaseDirectory, 'schema.sql')}"`.cwd(projectName);
+        const { Database } = await import('bun:sqlite');
+        const seeded = new Database(join(projectName, databaseDirectory, 'database.sqlite'));
+        seeded.run(sqliteSchema);
+        seeded.close();
     }
     if ((databaseHost === 'none' || databaseHost === undefined) &&
         databaseEngine !== 'sqlite' &&

package/dist/generators/html/generateHTMLPage.d.ts

@@ -1,2 +1,2 @@
 import { CreateConfiguration, Frontend } from '../../types';
-export declare const generateHTMLPage: (frontends: Frontend[], useHTMLScripts: CreateConfiguration["useHTMLScripts"], editBasePath: string, isSingleFrontend: boolean) => string;
+export declare const generateHTMLPage: (frontends: Frontend[], useHTMLScripts: CreateConfiguration["useHTMLScripts"], editBasePath: string, isSingleFrontend: boolean, includeExamples: boolean) => string;

package/dist/generators/html/generateHTMLPage.js

@@ -1,5 +1,22 @@
 import { formatNavLink } from '../../utils/formatNavLink';
-export const generateHTMLPage = (frontends, useHTMLScripts, editBasePath, isSingleFrontend) => {
+export const generateHTMLPage = (frontends, useHTMLScripts, editBasePath, isSingleFrontend, includeExamples) => {
+    const cssHref = `${isSingleFrontend ? '../../' : '../../../'}styles/indexes/html-example.css`;
+    if (!includeExamples) {
+        return `<!doctype html>
+<html>
+    <head>
+        <title>AbsoluteJS + HTML</title>
+        <meta charset="utf-8" />
+        <meta name="viewport" content="width=device-width, initial-scale=1" />
+        <link rel="stylesheet" type="text/css" href="${cssHref}" />
+        <link rel="icon" href="/assets/ico/favicon.ico" />
+    </head>
+    <body>
+        <main></main>
+    </body>
+</html>
+`;
+    }
     const navLinks = frontends.map(formatNavLink).join('\n\t\t\t');
     const initialCount = useHTMLScripts ? '0' : 'disabled';
     const scriptTagBlock = useHTMLScripts

package/dist/generators/html/scaffoldHTML.d.ts

@@ -2,5 +2,5 @@ import { ScaffoldFrontendProps } from '../../types';
 type ScaffoldHTMLProps = ScaffoldFrontendProps & {
     useHTMLScripts: boolean;
 };
-export declare const scaffoldHTML: ({ editBasePath, isSingleFrontend, targetDirectory, frontends, useHTMLScripts, templatesDirectory, projectAssetsDirectory, stylesIndexesDirectory }: ScaffoldHTMLProps) => void;
+export declare const scaffoldHTML: ({ editBasePath, includeExamples, isSingleFrontend, targetDirectory, frontends, useHTMLScripts, templatesDirectory, projectAssetsDirectory, stylesIndexesDirectory }: ScaffoldHTMLProps) => void;
 export {};

package/dist/generators/html/scaffoldHTML.js

@@ -2,10 +2,17 @@ import { copyFileSync, cpSync, mkdirSync, writeFileSync } from 'fs';
 import { join } from 'path';
 import { generateMarkupCSS } from '../project/generateMarkupCSS';
 import { generateHTMLPage } from './generateHTMLPage';
-export const scaffoldHTML = ({ editBasePath, isSingleFrontend, targetDirectory, frontends, useHTMLScripts, templatesDirectory, projectAssetsDirectory, stylesIndexesDirectory }) => {
-    copyFileSync(join(templatesDirectory, 'assets', 'svg', 'HTML5_Badge.svg'), join(projectAssetsDirectory, 'svg', 'HTML5_Badge.svg'));
-    const htmlPage = generateHTMLPage(frontends, useHTMLScripts, editBasePath, isSingleFrontend);
+export const scaffoldHTML = ({ editBasePath, includeExamples, isSingleFrontend, targetDirectory, frontends, useHTMLScripts, templatesDirectory, projectAssetsDirectory, stylesIndexesDirectory }) => {
     const pagesDirectory = join(targetDirectory, 'pages');
+    const cssOutputFile = join(stylesIndexesDirectory, 'html-example.css');
+    if (!includeExamples) {
+        mkdirSync(pagesDirectory, { recursive: true });
+        writeFileSync(join(pagesDirectory, 'HTMLExample.html'), generateHTMLPage(frontends, useHTMLScripts, editBasePath, isSingleFrontend, false), 'utf-8');
+        writeFileSync(cssOutputFile, `@import url('../reset.css');`, 'utf-8');
+        return;
+    }
+    copyFileSync(join(templatesDirectory, 'assets', 'svg', 'HTML5_Badge.svg'), join(projectAssetsDirectory, 'svg', 'HTML5_Badge.svg'));
+    const htmlPage = generateHTMLPage(frontends, useHTMLScripts, editBasePath, isSingleFrontend, true);
     mkdirSync(pagesDirectory, { recursive: true });
     const htmlFilePath = join(pagesDirectory, 'HTMLExample.html');
     writeFileSync(htmlFilePath, htmlPage, 'utf-8');
@@ -13,7 +20,6 @@ export const scaffoldHTML = ({ editBasePath, isSingleFrontend, targetDirectory,
     cpSync(join(templatesDirectory, 'html', 'scripts'), scriptsDirectory, {
         recursive: true
     });
-    const cssOutputFile = join(stylesIndexesDirectory, 'html-example.css');
     const htmlCSS = generateMarkupCSS('html', '#e34f26');
     writeFileSync(cssOutputFile, htmlCSS, 'utf-8');
 };

package/dist/generators/htmx/generateHTMXPage.d.ts

@@ -1,2 +1,2 @@
 import { Frontend } from '../../types';
-export declare const generateHTMXPage: (isSingle: boolean, frontends: Frontend[], editBasePath: string) => string;
+export declare const generateHTMXPage: (isSingle: boolean, frontends: Frontend[], editBasePath: string, includeExamples: boolean) => string;

package/dist/generators/htmx/generateHTMXPage.js

@@ -1,5 +1,26 @@
 import { formatNavLink } from '../../utils/formatNavLink';
-export const generateHTMXPage = (isSingle, frontends, editBasePath) => {
+export const generateHTMXPage = (isSingle, frontends, editBasePath, includeExamples) => {
+    if (!includeExamples) {
+        return `<!doctype html>
+<html>
+	<head>
+		<title>AbsoluteJS + HTMX</title>
+		<meta charset="utf-8" />
+		<meta name="viewport" content="width=device-width, initial-scale=1" />
+		<link
+			rel="stylesheet"
+			type="text/css"
+			href="${isSingle ? '../../' : '../../../'}styles/indexes/htmx-example.css"
+		/>
+		<link rel="icon" href="/assets/ico/favicon.ico" />
+		<script src="${isSingle ? '' : '/htmx'}/htmx.min.js"></script>
+	</head>
+	<body>
+		<main></main>
+	</body>
+</html>
+`;
+    }
     const navLinks = frontends.map(formatNavLink).join('\n\t\t\t');
     return `<!doctype html>
 <html>

package/dist/generators/htmx/scaffoldHTMX.d.ts

@@ -1,2 +1,2 @@
 import { ScaffoldFrontendProps } from '../../types';
-export declare const scaffoldHTMX: ({ editBasePath, targetDirectory, templatesDirectory, projectAssetsDirectory, frontends, isSingleFrontend, stylesIndexesDirectory }: ScaffoldFrontendProps) => void;
+export declare const scaffoldHTMX: ({ editBasePath, includeExamples, targetDirectory, templatesDirectory, projectAssetsDirectory, frontends, isSingleFrontend, stylesIndexesDirectory }: ScaffoldFrontendProps) => void;

package/dist/generators/htmx/scaffoldHTMX.js

@@ -3,9 +3,10 @@ import { join } from 'path';
 import { Glob } from 'bun';
 import { generateMarkupCSS } from '../project/generateMarkupCSS';
 import { generateHTMXPage } from './generateHTMXPage';
-export const scaffoldHTMX = ({ editBasePath, targetDirectory, templatesDirectory, projectAssetsDirectory, frontends, isSingleFrontend, stylesIndexesDirectory }) => {
-    copyFileSync(join(templatesDirectory, 'assets', 'svg', 'htmx-logo-black.svg'), join(projectAssetsDirectory, 'svg', 'htmx-logo-black.svg'));
-    copyFileSync(join(templatesDirectory, 'assets', 'svg', 'htmx-logo-white.svg'), join(projectAssetsDirectory, 'svg', 'htmx-logo-white.svg'));
+export const scaffoldHTMX = ({ editBasePath, includeExamples, targetDirectory, templatesDirectory, projectAssetsDirectory, frontends, isSingleFrontend, stylesIndexesDirectory }) => {
+    const pagesDirectory = join(targetDirectory, 'pages');
+    const cssOutputFile = join(stylesIndexesDirectory, 'htmx-example.css');
+    // htmx.min.js is the framework runtime, copied in both modes.
     const glob = new Glob('htmx*.min.js');
     for (const relativePath of glob.scanSync({
         cwd: join(templatesDirectory, 'htmx')
@@ -15,12 +16,18 @@ export const scaffoldHTMX = ({ editBasePath, targetDirectory, templatesDirectory
         copyFileSync(src, dest);
         break;
     }
-    const htmxPage = generateHTMXPage(isSingleFrontend, frontends, editBasePath);
-    const pagesDirectory = join(targetDirectory, 'pages');
+    if (!includeExamples) {
+        mkdirSync(pagesDirectory, { recursive: true });
+        writeFileSync(join(pagesDirectory, 'HTMXExample.html'), generateHTMXPage(isSingleFrontend, frontends, editBasePath, false), 'utf-8');
+        writeFileSync(cssOutputFile, `@import url('../reset.css');`, 'utf-8');
+        return;
+    }
+    copyFileSync(join(templatesDirectory, 'assets', 'svg', 'htmx-logo-black.svg'), join(projectAssetsDirectory, 'svg', 'htmx-logo-black.svg'));
+    copyFileSync(join(templatesDirectory, 'assets', 'svg', 'htmx-logo-white.svg'), join(projectAssetsDirectory, 'svg', 'htmx-logo-white.svg'));
+    const htmxPage = generateHTMXPage(isSingleFrontend, frontends, editBasePath, true);
     mkdirSync(pagesDirectory, { recursive: true });
     const htmxFilePath = join(pagesDirectory, 'HTMXExample.html');
     writeFileSync(htmxFilePath, htmxPage, 'utf-8');
-    const cssOutputFile = join(stylesIndexesDirectory, 'htmx-example.css');
     const htmxCSS = generateMarkupCSS('htmx', '#3465a4');
     writeFileSync(cssOutputFile, htmxCSS, 'utf-8');
 };

package/dist/generators/project/scaffoldFrontends.d.ts

@@ -1,9 +1,9 @@
 import type { CreateConfiguration } from '../../types';
-type ScaffoldFrontendsProps = Pick<CreateConfiguration, 'useHTMLScripts' | 'frontendDirectories' | 'assetsDirectory' | 'frontends' | 'authOption' | 'absProviders' | 'useTailwind'> & {
+type ScaffoldFrontendsProps = Pick<CreateConfiguration, 'useHTMLScripts' | 'frontendDirectories' | 'assetsDirectory' | 'frontends' | 'authOption' | 'absProviders' | 'includeExamples' | 'useTailwind'> & {
     frontendDirectory: string;
     templatesDirectory: string;
     projectAssetsDirectory: string;
     typesDirectory: string;
 };
-export declare const scaffoldFrontends: ({ frontendDirectory, assetsDirectory, absProviders, authOption, templatesDirectory, projectAssetsDirectory, typesDirectory, useHTMLScripts, useTailwind, frontendDirectories, frontends }: ScaffoldFrontendsProps) => void;
+export declare const scaffoldFrontends: ({ frontendDirectory, assetsDirectory, absProviders, authOption, includeExamples, templatesDirectory, projectAssetsDirectory, typesDirectory, useHTMLScripts, useTailwind, frontendDirectories, frontends }: ScaffoldFrontendsProps) => void;
 export {};

package/dist/generators/project/scaffoldFrontends.js

@@ -6,7 +6,7 @@ import { scaffoldHTMX } from '../htmx/scaffoldHTMX';
 import { scaffoldReact } from '../react/scaffoldReact';
 import { scaffoldSvelte } from '../svelte/scaffoldSvelte';
 import { scaffoldVue } from '../vue/scaffoldVue';
-export const scaffoldFrontends = ({ frontendDirectory, assetsDirectory, absProviders, authOption, templatesDirectory, projectAssetsDirectory, typesDirectory, useHTMLScripts, useTailwind, frontendDirectories, frontends }) => {
+export const scaffoldFrontends = ({ frontendDirectory, assetsDirectory, absProviders, authOption, includeExamples, templatesDirectory, projectAssetsDirectory, typesDirectory, useHTMLScripts, useTailwind, frontendDirectories, frontends }) => {
     const srcDirectory = dirname(frontendDirectory);
     const globalStylesDirectory = join(srcDirectory, 'styles');
     const stylesIndexesDirectory = join(globalStylesDirectory, 'indexes');
@@ -42,6 +42,7 @@ export const scaffoldFrontends = ({ frontendDirectory, assetsDirectory, absProvi
                     authOption,
                     editBasePath,
                     frontends,
+                    includeExamples,
                     isSingleFrontend,
                     projectAssetsDirectory,
                     stylesDirectory: stylesTargetDirectory,
@@ -57,6 +58,7 @@ export const scaffoldFrontends = ({ frontendDirectory, assetsDirectory, absProvi
                     authOption,
                     editBasePath,
                     frontends,
+                    includeExamples,
                     isSingleFrontend,
                     projectAssetsDirectory,
                     stylesDirectory: stylesTargetDirectory,
@@ -72,6 +74,7 @@ export const scaffoldFrontends = ({ frontendDirectory, assetsDirectory, absProvi
                     authOption,
                     editBasePath,
                     frontends,
+                    includeExamples,
                     projectAssetsDirectory,
                     stylesDirectory: stylesTargetDirectory,
                     stylesIndexesDirectory,
@@ -87,6 +90,7 @@ export const scaffoldFrontends = ({ frontendDirectory, assetsDirectory, absProvi
                     authOption,
                     editBasePath,
                     frontends,
+                    includeExamples,
                     isSingleFrontend,
                     projectAssetsDirectory,
                     stylesDirectory: stylesTargetDirectory,
@@ -102,6 +106,7 @@ export const scaffoldFrontends = ({ frontendDirectory, assetsDirectory, absProvi
                     authOption,
                     editBasePath,
                     frontends,
+                    includeExamples,
                     isSingleFrontend,
                     projectAssetsDirectory,
                     stylesDirectory: stylesTargetDirectory,
@@ -118,6 +123,7 @@ export const scaffoldFrontends = ({ frontendDirectory, assetsDirectory, absProvi
                     authOption,
                     editBasePath,
                     frontends,
+                    includeExamples,
                     isSingleFrontend,
                     projectAssetsDirectory,
                     stylesDirectory: stylesTargetDirectory,

package/dist/generators/react/generateReactComponents.d.ts

@@ -2,5 +2,5 @@ import { ProviderOption } from '@absolutejs/auth';
 import { AuthOption, Frontend } from '../../types';
 export declare const generateAppComponent: (frontends: Frontend[], editBasePath: string) => string;
 export declare const generateDropdownComponent: (frontends: Frontend[]) => string;
-export declare const generateReactExamplePage: (authOption: AuthOption) => string;
+export declare const generateReactExamplePage: (authOption: AuthOption, includeExamples: boolean) => string;
 export declare const generateSignInComponent: (absProviders: ProviderOption[] | undefined) => string;

package/dist/generators/react/generateReactComponents.js

@@ -73,7 +73,31 @@ export const generateDropdownComponent = (frontends) => {
 );
 `;
 };
-export const generateReactExamplePage = (authOption) => {
+export const generateReactExamplePage = (authOption, includeExamples) => {
+    if (!includeExamples) {
+        const authImports = authOption === 'abs'
+            ? `import type { User } from '../../../types/databaseTypes';\nimport type { ProviderConfiguration } from '@absolutejs/auth';\n`
+            : '';
+        const authProps = authOption === 'abs'
+            ? '\n\tuser: User | null;\n\tproviderConfiguration: ProviderConfiguration | undefined;'
+            : '';
+        return `${authImports}import { Head } from '../components/Head';
+
+type ReactExampleProps = {
+	initialCount: number;
+	cssPath: string;${authProps}
+};
+
+export const ReactExample = ({ cssPath }: ReactExampleProps) => (
+	<html>
+		<Head cssPath={cssPath} />
+		<body>
+			<main></main>
+		</body>
+	</html>
+);
+`;
+    }
     const useBlockReturn = authOption === 'abs';
     const propsType = `
 		type ReactExampleProps = { 

package/dist/generators/react/scaffoldReact.d.ts

@@ -1,2 +1,2 @@
 import { ScaffoldFrontendProps } from '../../types';
-export declare const scaffoldReact: ({ authOption, editBasePath, targetDirectory, templatesDirectory, frontends, projectAssetsDirectory, absProviders, stylesIndexesDirectory }: ScaffoldFrontendProps) => void;
+export declare const scaffoldReact: ({ authOption, editBasePath, includeExamples, targetDirectory, templatesDirectory, frontends, projectAssetsDirectory, absProviders, stylesIndexesDirectory }: ScaffoldFrontendProps) => void;

package/dist/generators/react/scaffoldReact.js

@@ -2,7 +2,15 @@ import { copyFileSync, cpSync, mkdirSync, writeFileSync } from 'fs';
 import { join } from 'path';
 import { generateMarkupCSS } from '../project/generateMarkupCSS';
 import { generateAppComponent, generateDropdownComponent, generateReactExamplePage, generateSignInComponent } from './generateReactComponents';
-export const scaffoldReact = ({ authOption, editBasePath, targetDirectory, templatesDirectory, frontends, projectAssetsDirectory, absProviders, stylesIndexesDirectory }) => {
+export const scaffoldReact = ({ authOption, editBasePath, includeExamples, targetDirectory, templatesDirectory, frontends, projectAssetsDirectory, absProviders, stylesIndexesDirectory }) => {
+    if (!includeExamples) {
+        mkdirSync(join(targetDirectory, 'components'), { recursive: true });
+        copyFileSync(join(templatesDirectory, 'react', 'components', 'Head.tsx'), join(targetDirectory, 'components', 'Head.tsx'));
+        mkdirSync(join(targetDirectory, 'pages'), { recursive: true });
+        writeFileSync(join(targetDirectory, 'pages', 'ReactExample.tsx'), generateReactExamplePage(authOption, false), 'utf-8');
+        writeFileSync(join(stylesIndexesDirectory, 'react-example.css'), `@import url('../reset.css');`, 'utf-8');
+        return;
+    }
     mkdirSync(join(projectAssetsDirectory, 'svg'), { recursive: true });
     copyFileSync(join(templatesDirectory, 'assets', 'svg', 'react.svg'), join(projectAssetsDirectory, 'svg', 'react.svg'));
     copyFileSync(join(templatesDirectory, 'assets', 'svg', 'google-logo.svg'), join(projectAssetsDirectory, 'svg', 'google-logo.svg'));
@@ -17,7 +25,7 @@ export const scaffoldReact = ({ authOption, editBasePath, targetDirectory, templ
         const signInComponent = generateSignInComponent(absProviders);
         writeFileSync(join(targetDirectory, 'components', 'SignIn.tsx'), signInComponent, 'utf-8');
     }
-    const pageComponent = generateReactExamplePage(authOption);
+    const pageComponent = generateReactExamplePage(authOption, true);
     mkdirSync(join(targetDirectory, 'pages'), { recursive: true });
     writeFileSync(join(targetDirectory, 'pages', 'ReactExample.tsx'), pageComponent, 'utf-8');
     const cssOutputFile = join(stylesIndexesDirectory, 'react-example.css');

package/dist/generators/svelte/generateSveltePage.d.ts

@@ -1,2 +1,2 @@
 import { Frontend } from '../../types';
-export declare const generateSveltePage: (frontends: Frontend[], editBasePath: string) => string;
+export declare const generateSveltePage: (frontends: Frontend[], editBasePath: string, includeExamples: boolean) => string;

package/dist/generators/svelte/generateSveltePage.js

@@ -1,5 +1,26 @@
 import { formatNavLink } from '../../utils/formatNavLink';
-export const generateSveltePage = (frontends, editBasePath) => {
+export const generateSveltePage = (frontends, editBasePath, includeExamples) => {
+    if (!includeExamples) {
+        return `<script lang="ts">
+	type SvelteExampleProps = {
+		initialCount: number;
+		cssPath: string;
+	};
+
+	let { cssPath }: SvelteExampleProps = $props();
+</script>
+
+<svelte:head>
+	<meta charset="utf-8" />
+	<title>AbsoluteJS + Svelte</title>
+	<meta name="viewport" content="width=device-width, initial-scale=1" />
+	<link rel="icon" href="/assets/ico/favicon.ico" />
+	<link rel="stylesheet" href={cssPath} type="text/css" />
+</svelte:head>
+
+<main></main>
+`;
+    }
     const navLinks = frontends.map(formatNavLink).join('\n\t\t\t');
     return `<script lang="ts">
 	type SvelteExampleProps = {

package/dist/generators/svelte/scaffoldSvelte.d.ts

@@ -1,2 +1,2 @@
 import { ScaffoldFrontendProps } from '../../types';
-export declare const scaffoldSvelte: ({ editBasePath, targetDirectory, frontends, templatesDirectory, projectAssetsDirectory, stylesIndexesDirectory }: ScaffoldFrontendProps) => void;
+export declare const scaffoldSvelte: ({ editBasePath, includeExamples, targetDirectory, frontends, templatesDirectory, projectAssetsDirectory, stylesIndexesDirectory }: ScaffoldFrontendProps) => void;

package/dist/generators/svelte/scaffoldSvelte.js

@@ -1,17 +1,23 @@
 import { copyFileSync, cpSync, mkdirSync, writeFileSync } from 'fs';
 import { join } from 'path';
 import { generateSveltePage } from './generateSveltePage';
-export const scaffoldSvelte = ({ editBasePath, targetDirectory, frontends, templatesDirectory, projectAssetsDirectory, stylesIndexesDirectory }) => {
+export const scaffoldSvelte = ({ editBasePath, includeExamples, targetDirectory, frontends, templatesDirectory, projectAssetsDirectory, stylesIndexesDirectory }) => {
+    const pagesDirectory = join(targetDirectory, 'pages');
+    const cssOutputFile = join(stylesIndexesDirectory, 'svelte-example.css');
+    const svelteCSS = `@import url('../reset.css');`;
+    if (!includeExamples) {
+        mkdirSync(pagesDirectory, { recursive: true });
+        writeFileSync(join(pagesDirectory, 'SvelteExample.svelte'), generateSveltePage(frontends, editBasePath, false), 'utf-8');
+        writeFileSync(cssOutputFile, svelteCSS, 'utf-8');
+        return;
+    }
     copyFileSync(join(templatesDirectory, 'assets', 'svg', 'svelte-logo.svg'), join(projectAssetsDirectory, 'svg', 'svelte-logo.svg'));
     cpSync(join(templatesDirectory, 'svelte'), targetDirectory, {
         recursive: true
     });
-    const sveltePage = generateSveltePage(frontends, editBasePath);
-    const pagesDirectory = join(targetDirectory, 'pages');
+    const sveltePage = generateSveltePage(frontends, editBasePath, true);
     mkdirSync(pagesDirectory, { recursive: true });
     const svelteFilePath = join(pagesDirectory, 'SvelteExample.svelte');
     writeFileSync(svelteFilePath, sveltePage, 'utf-8');
-    const cssOutputFile = join(stylesIndexesDirectory, 'svelte-example.css');
-    const svelteCSS = `@import url('../reset.css');`;
     writeFileSync(cssOutputFile, svelteCSS, 'utf-8');
 };

package/dist/generators/vue/generateVuePage.d.ts

@@ -1,2 +1,2 @@
 import { Frontend } from '../../types';
-export declare const generateVuePage: (frontends: Frontend[], editBasePath: string) => string;
+export declare const generateVuePage: (frontends: Frontend[], editBasePath: string, includeExamples: boolean) => string;

package/dist/generators/vue/generateVuePage.js

@@ -1,5 +1,27 @@
 import { formatNavLink } from '../../utils/formatNavLink';
-export const generateVuePage = (frontends, editBasePath) => {
+export const generateVuePage = (frontends, editBasePath, includeExamples) => {
+    if (!includeExamples) {
+        return `<script setup lang="ts">
+defineProps<{
+	initialCount: number;
+}>();
+</script>
+
+<template>
+	<main></main>
+</template>
+
+<style scoped>
+:global(#root) {
+	display: flex;
+	flex-direction: column;
+	margin: 0 auto;
+	height: 100%;
+	width: 100%;
+}
+</style>
+`;
+    }
     const navLinks = frontends.map(formatNavLink).join('\n\t\t\t');
     return `<script setup lang="ts">
 import CountButton from '../components/CountButton.vue';

package/dist/generators/vue/scaffoldVue.d.ts

@@ -1,4 +1,4 @@
 import { ScaffoldFrontendProps } from '../../types';
 type ScaffoldVueProps = Omit<ScaffoldFrontendProps, 'isSingleFrontend'>;
-export declare const scaffoldVue: ({ editBasePath, targetDirectory, templatesDirectory, frontends, projectAssetsDirectory, stylesIndexesDirectory }: ScaffoldVueProps) => void;
+export declare const scaffoldVue: ({ editBasePath, includeExamples, targetDirectory, templatesDirectory, frontends, projectAssetsDirectory, stylesIndexesDirectory }: ScaffoldVueProps) => void;
 export {};

package/dist/generators/vue/scaffoldVue.js

@@ -2,17 +2,23 @@ import { cpSync, copyFileSync, mkdirSync, writeFileSync } from 'fs';
 import { join } from 'path';
 import { generateMarkupCSS } from '../project/generateMarkupCSS';
 import { generateVuePage } from './generateVuePage';
-export const scaffoldVue = ({ editBasePath, targetDirectory, templatesDirectory, frontends, projectAssetsDirectory, stylesIndexesDirectory }) => {
+export const scaffoldVue = ({ editBasePath, includeExamples, targetDirectory, templatesDirectory, frontends, projectAssetsDirectory, stylesIndexesDirectory }) => {
+    const cssOutputFile = join(stylesIndexesDirectory, 'vue-example.css');
+    const pagesDirectory = join(targetDirectory, 'pages');
+    if (!includeExamples) {
+        mkdirSync(pagesDirectory, { recursive: true });
+        writeFileSync(join(pagesDirectory, 'VueExample.vue'), generateVuePage(frontends, editBasePath, false), 'utf-8');
+        writeFileSync(cssOutputFile, `@import url('../reset.css');`, 'utf-8');
+        return;
+    }
     copyFileSync(join(templatesDirectory, 'assets', 'svg', 'vue-logo.svg'), join(projectAssetsDirectory, 'svg', 'vue-logo.svg'));
     cpSync(join(templatesDirectory, 'vue'), targetDirectory, {
         recursive: true
     });
-    const vuePage = generateVuePage(frontends, editBasePath);
-    const pagesDirectory = join(targetDirectory, 'pages');
+    const vuePage = generateVuePage(frontends, editBasePath, true);
     mkdirSync(pagesDirectory, { recursive: true });
     const vueFilePath = join(pagesDirectory, 'VueExample.vue');
     writeFileSync(vueFilePath, vuePage, 'utf-8');
-    const cssOutputFile = join(stylesIndexesDirectory, 'vue-example.css');
     const vueCSS = generateMarkupCSS('vue', '#42b883');
     writeFileSync(cssOutputFile, vueCSS, 'utf-8');
 };

package/dist/messages.d.ts

@@ -10,5 +10,5 @@ type DebugMessageProps = {
     response: CreateConfiguration;
     packageManager: string;
 };
-export declare const getDebugMessage: ({ response: { projectName, codeQualityTool, directoryConfig, useTailwind, tailwind, frontends, useHTMLScripts, frontendDirectories, buildDirectory, assetsDirectory, databaseEngine, databaseHost, databaseDirectory, orm, authOption, plugins, initializeGitNow, installDependenciesNow }, packageManager }: DebugMessageProps) => string;
+export declare const getDebugMessage: ({ response: { projectName, codeQualityTool, directoryConfig, useTailwind, tailwind, frontends, includeExamples, useHTMLScripts, frontendDirectories, buildDirectory, assetsDirectory, databaseEngine, databaseHost, databaseDirectory, orm, authOption, plugins, initializeGitNow, installDependenciesNow }, packageManager }: DebugMessageProps) => string;
 export {};

package/dist/messages.js

@@ -31,6 +31,7 @@ Options:
   ${cyan('--htmx-dir')} ${dim(cyan('<directory>'))}          Specify the directory for and use the HTMX frontend
   ${cyan('--install')}                       Use the same package manager to install dependencies
   ${cyan('--lts')}                           Use LTS versions of required packages
+  ${cyan('--no-examples')}                   Generate a bare, bootable skeleton without example pages, components, or demo styles
   ${cyan('--orm')} ${dim(cyan('<orm>'))}                     ORM to configure: "drizzle" | "prisma" | 'none'
   ${cyan('--plugin')} ${dim(cyan('<plugin>'))}               Elysia plugin(s) to include (repeatable); 'none' skips plugin setup
   ${cyan('--react')}                         Include a React frontend
@@ -48,7 +49,7 @@ export const getOutroMessage = ({ projectName, packageManager, installDependenci
     `${cyan('cd')} ${projectName}\n` +
     `${installDependenciesNow ? '' : `${cyan(`${packageManager} install`)}\n`}` +
     `${cyan(`${packageManager} dev`)}`; // TODO: Some package managers need run
-export const getDebugMessage = ({ response: { projectName, codeQualityTool, directoryConfig, useTailwind, tailwind, frontends, useHTMLScripts, frontendDirectories, buildDirectory, assetsDirectory, databaseEngine, databaseHost, databaseDirectory, orm, authOption, plugins, initializeGitNow, installDependenciesNow }, packageManager }) => {
+export const getDebugMessage = ({ response: { projectName, codeQualityTool, directoryConfig, useTailwind, tailwind, frontends, includeExamples, useHTMLScripts, frontendDirectories, buildDirectory, assetsDirectory, databaseEngine, databaseHost, databaseDirectory, orm, authOption, plugins, initializeGitNow, installDependenciesNow }, packageManager }) => {
     const htmlScriptingValue = useHTMLScripts
         ? blueBright('TypeScript')
         : dim('None');
@@ -68,6 +69,7 @@ export const getDebugMessage = ({ response: { projectName, codeQualityTool, dire
         ['Tailwind Configuration', tailwindSection],
         [frontends.length === 1 ? 'Frontend' : 'Frontends', frontends.map((name) => frontendLabels[name]).join(', ')],
         ['HTML Scripting', frontends.includes('html') ? htmlScriptingValue : dim('None')],
+        ['Example Content', includeExamples ? green('Yes') : red('No')],
         ['Build Directory', buildDirectory],
         ['Assets Directory', assetsDirectory],
         ['Database Engine', databaseEngine && databaseEngine !== 'none' ? databaseEngine : dim('None')],

package/dist/prompt.js

@@ -8,37 +8,41 @@ import { getFrontendDirectoryConfigurations } from './questions/frontendDirector
 import { getFrontends } from './questions/frontends';
 import { getGithubLink } from './questions/githubLink';
 import { getHtmlScriptingOption } from './questions/htmlScriptingOption';
+import { getIncludeExamples } from './questions/includeExamples';
 import { getInitializeGit } from './questions/initializeGitNow';
 import { getInstallDependencies } from './questions/installDependenciesNow';
 import { getORM } from './questions/orm';
 import { getPlugins } from './questions/plugins';
 import { getProjectName } from './questions/projectName';
 import { getUseTailwind } from './questions/useTailwind';
+import { orPrompt } from './utils/interactive';
 export const prompt = async (argumentConfiguration) => {
     // 1. Project name
-    const projectName = argumentConfiguration.projectName ?? (await getProjectName());
+    const projectName = argumentConfiguration.projectName ?? (await orPrompt('a project name', getProjectName));
     // 2. Linting/formatting tool
-    const codeQualityTool = argumentConfiguration.codeQualityTool ?? (await getCodeQualityTool());
+    const codeQualityTool = argumentConfiguration.codeQualityTool ?? (await orPrompt('--eslint+prettier/--biome', getCodeQualityTool));
     // 3. Tailwind support?
-    const useTailwind = argumentConfiguration.useTailwind ?? (await getUseTailwind());
+    const useTailwind = argumentConfiguration.useTailwind ?? (await orPrompt('--tailwind/--no-tailwind', getUseTailwind));
     // 4. Frontend(s)
-    const frontends = argumentConfiguration.frontends?.filter((frontend) => frontend !== undefined) ?? (await getFrontends());
+    const frontends = argumentConfiguration.frontends?.filter((frontend) => frontend !== undefined) ?? (await orPrompt('--react/--vue/--svelte/…', getFrontends));
     // 5. HTML scripting option (if HTML was selected)
     const useHTMLScripts = frontends.includes('html')
         ? (argumentConfiguration.useHTMLScripts ??
-            (await getHtmlScriptingOption()))
+            (await orPrompt('--html-scripts/--no-html-scripts', getHtmlScriptingOption)))
         : false;
+    // 5b. Include example pages/components, or generate a bare skeleton
+    const includeExamples = argumentConfiguration.includeExamples ?? (await orPrompt('--examples/--no-examples', getIncludeExamples));
     // 6. Database engine
-    const databaseEngine = argumentConfiguration.databaseEngine ?? (await getDatabaseEngine());
+    const databaseEngine = argumentConfiguration.databaseEngine ?? (await orPrompt('--db', getDatabaseEngine));
     // 7. Database host
     const databaseHost = argumentConfiguration.databaseHost ??
-        (await getDatabaseHost(databaseEngine));
+        (await orPrompt('--db-host', () => getDatabaseHost(databaseEngine)));
     // 8. ORM choice
     const orm = databaseEngine !== undefined && databaseEngine !== 'none'
-        ? (argumentConfiguration.orm ?? (await getORM(databaseEngine)))
+        ? (argumentConfiguration.orm ?? (await orPrompt('--orm', () => getORM(databaseEngine))))
         : undefined;
     // 9. Configuration type
-    let directoryConfig = argumentConfiguration.directoryConfig ?? (await getConfigurationType());
+    let directoryConfig = argumentConfiguration.directoryConfig ?? (await orPrompt('--directory', getConfigurationType));
     // 10. Directory configurations
     const { buildDirectory, assetsDirectory, tailwind, databaseDirectory } = await getDirectoryConfiguration({
         argumentConfiguration,
@@ -52,11 +56,11 @@ export const prompt = async (argumentConfiguration) => {
     if (argumentConfiguration.frontendDirectories !== undefined)
         directoryConfig = 'custom';
     // 12. Auth provider
-    const authOption = argumentConfiguration.authOption ?? (await getAuthOption());
+    const authOption = argumentConfiguration.authOption ?? (await orPrompt('--auth', getAuthOption));
     // 13. Additional plugins
-    const plugins = argumentConfiguration.plugins?.filter((plugin) => plugin !== undefined) ?? (await getPlugins());
+    const plugins = argumentConfiguration.plugins?.filter((plugin) => plugin !== undefined) ?? (await orPrompt('--plugin', getPlugins));
     // 14. Initialize Git repository
-    const initializeGitNow = argumentConfiguration.initializeGitNow ?? (await getInitializeGit());
+    const initializeGitNow = argumentConfiguration.initializeGitNow ?? (await orPrompt('--git/--no-git', getInitializeGit));
     // 14b. Optionally connect the new project to GitHub
     const resolveGithubLink = async () => {
         if (!initializeGitNow) {
@@ -73,12 +77,12 @@ export const prompt = async (argumentConfiguration) => {
                 githubVisibility: argumentConfiguration.githubVisibility
             };
         }
-        return getGithubLink(projectName);
+        return orPrompt('--repo/--repo-visibility', () => getGithubLink(projectName));
     };
     const { githubLink, githubRepoUrl, githubVisibility } = await resolveGithubLink();
     // 15. Install dependencies
     const installDependenciesNow = argumentConfiguration.installDependenciesNow ??
-        (await getInstallDependencies());
+        (await orPrompt('--install/--no-install', getInstallDependencies));
     const values = {
         absProviders: argumentConfiguration.absProviders?.filter((provider) => provider !== undefined),
         assetsDirectory,
@@ -94,6 +98,7 @@ export const prompt = async (argumentConfiguration) => {
         githubLink,
         githubRepoUrl,
         githubVisibility,
+        includeExamples,
         initializeGitNow,
         installDependenciesNow,
         orm,

package/dist/questions/directoryConfiguration.js

@@ -1,5 +1,7 @@
 import { text, isCancel } from '@clack/prompts';
 import { abort } from '../utils/abort';
+import { orPrompt } from '../utils/interactive';
+const orPromptText = (options) => orPrompt(`a value for "${String(options.message)}" (pass the matching --*-dir flag)`, () => text(options));
 export const getDirectoryConfiguration = async ({ directoryConfig, useTailwind, databaseEngine, argumentConfiguration }) => {
     if (directoryConfig === 'default') {
         return {
@@ -20,7 +22,7 @@ export const getDirectoryConfiguration = async ({ directoryConfig, useTailwind,
     }
     // Build directory
     const buildDirectory = argumentConfiguration.buildDirectory ??
-        (await text({
+        (await orPromptText({
             message: 'Build directory:',
             placeholder: 'build'
         }));
@@ -28,7 +30,7 @@ export const getDirectoryConfiguration = async ({ directoryConfig, useTailwind,
         abort();
     // Assets directory
     const assetsDirectory = argumentConfiguration.assetsDirectory ??
-        (await text({
+        (await orPromptText({
             message: 'Assets directory:',
             placeholder: 'src/backend/assets'
         }));
@@ -38,14 +40,14 @@ export const getDirectoryConfiguration = async ({ directoryConfig, useTailwind,
     let tailwind;
     if (useTailwind) {
         const input = argumentConfiguration.tailwind?.input ??
-            (await text({
+            (await orPromptText({
                 message: 'Tailwind input CSS file:',
                 placeholder: './src/frontend/styles/tailwind.css'
             }));
         if (isCancel(input))
             abort();
         const output = argumentConfiguration.tailwind?.output ??
-            (await text({
+            (await orPromptText({
                 message: 'Tailwind output CSS file:',
                 placeholder: 'assets/css/tailwind.generated.css'
             }));
@@ -61,7 +63,7 @@ export const getDirectoryConfiguration = async ({ directoryConfig, useTailwind,
     if (databaseEngine !== undefined && databaseEngine !== 'none') {
         databaseDirectory =
             argumentConfiguration.databaseDirectory ??
-                (await text({
+                (await orPromptText({
                     message: 'Database directory:',
                     placeholder: 'db'
                 }));

package/dist/questions/frontendDirectoryConfigurations.js

@@ -1,13 +1,14 @@
 import { text, isCancel } from '@clack/prompts';
 import { frontendLabels } from '../data';
 import { abort } from '../utils/abort';
+import { orPrompt } from '../utils/interactive';
 const getDirectoryForFrontend = async (directoryConfiguration, frontend, isSingleFrontend) => {
     if (directoryConfiguration !== 'custom')
         return isSingleFrontend ? '' : frontend;
-    const response = await text({
+    const response = await orPrompt(`the ${frontendLabels[frontend]} directory (pass --<frontend>-dir)`, () => text({
         message: `${frontendLabels[frontend]} directory:`,
         placeholder: isSingleFrontend ? '' : frontend
-    });
+    }));
     if (isCancel(response))
         abort();
     return response;

package/dist/questions/includeExamples.d.ts

@@ -0,0 +1 @@
+export declare const getIncludeExamples: () => Promise<boolean>;

package/dist/questions/includeExamples.js

@@ -0,0 +1,11 @@
+import { confirm, isCancel } from '@clack/prompts';
+import { abort } from '../utils/abort';
+export const getIncludeExamples = async () => {
+    const includeExamples = await confirm({
+        initialValue: true,
+        message: 'Include example pages and components?'
+    });
+    if (isCancel(includeExamples))
+        abort();
+    return includeExamples;
+};

package/dist/scaffold.d.ts

@@ -5,7 +5,7 @@ type ScaffoldProps = {
     latest: boolean;
     envVariables: string[] | undefined;
 };
-export declare const scaffold: ({ response: { projectName, codeQualityTool, initializeGitNow, githubLink, githubRepoUrl, githubVisibility, databaseEngine, databaseHost, useHTMLScripts, useTailwind, databaseDirectory, absProviders, orm, frontends, plugins, authOption, buildDirectory, assetsDirectory, tailwind, installDependenciesNow, frontendDirectories }, latest, envVariables, packageManager }: ScaffoldProps) => Promise<{
+export declare const scaffold: ({ response: { projectName, codeQualityTool, initializeGitNow, githubLink, githubRepoUrl, githubVisibility, databaseEngine, databaseHost, useHTMLScripts, useTailwind, databaseDirectory, absProviders, includeExamples, orm, frontends, plugins, authOption, buildDirectory, assetsDirectory, tailwind, installDependenciesNow, frontendDirectories }, latest, envVariables, packageManager }: ScaffoldProps) => Promise<{
     dockerFreshInstall: boolean;
 }>;
 export {};

package/dist/scaffold.js

@@ -10,7 +10,7 @@ import { scaffoldConfigurationFiles } from './generators/configurations/scaffold
 import { scaffoldDatabase } from './generators/db/scaffoldDatabase';
 import { scaffoldBackend } from './generators/project/scaffoldBackend';
 import { scaffoldFrontends } from './generators/project/scaffoldFrontends';
-export const scaffold = async ({ response: { projectName, codeQualityTool, initializeGitNow, githubLink, githubRepoUrl, githubVisibility, databaseEngine, databaseHost, useHTMLScripts, useTailwind, databaseDirectory, absProviders, orm, frontends, plugins, authOption, buildDirectory, assetsDirectory, tailwind, installDependenciesNow, frontendDirectories }, latest, envVariables, packageManager }) => {
+export const scaffold = async ({ response: { projectName, codeQualityTool, initializeGitNow, githubLink, githubRepoUrl, githubVisibility, databaseEngine, databaseHost, useHTMLScripts, useTailwind, databaseDirectory, absProviders, includeExamples, orm, frontends, plugins, authOption, buildDirectory, assetsDirectory, tailwind, installDependenciesNow, frontendDirectories }, latest, envVariables, packageManager }) => {
     const __dirname = dirname(fileURLToPath(import.meta.url));
     const templatesDirectory = join(__dirname, '/templates');
     const { frontendDirectory, backendDirectory, projectAssetsDirectory, typesDirectory } = initalizeRoot(projectName, templatesDirectory);
@@ -76,6 +76,7 @@ export const scaffold = async ({ response: { projectName, codeQualityTool, initi
         frontendDirectories,
         frontendDirectory,
         frontends,
+        includeExamples,
         projectAssetsDirectory,
         templatesDirectory,
         typesDirectory,

package/dist/types.d.ts

@@ -5,6 +5,7 @@ export type ScaffoldFrontendProps = {
     assetsDirectory: string;
     authOption: AuthOption;
     editBasePath: string;
+    includeExamples: boolean;
     targetDirectory: string;
     templatesDirectory: string;
     projectAssetsDirectory: string;
@@ -50,6 +51,7 @@ export type CreateConfiguration = {
     databaseEngine: DatabaseEngine;
     frontendDirectories: FrontendDirectories;
     frontends: Frontend[];
+    includeExamples: boolean;
     useHTMLScripts: boolean;
     initializeGitNow: boolean;
     githubLink: GithubLinkOption;

package/dist/utils/checkSqliteInstalled.js

@@ -1,5 +1,5 @@
 import os from 'os';
-import { env, platform } from 'process';
+import { env, platform, stdin, stdout } from 'process';
 import { confirm, spinner } from '@clack/prompts';
 import { $ } from 'bun';
 import { dim, yellow } from 'picocolors';
@@ -109,9 +109,17 @@ const installLinuxSqlite = async () => {
 export const checkSqliteInstalled = async () => {
     if (await hasSqlite())
         return;
+    // Non-interactive contexts (the Studio container, CI, any piped stdin)
+    // must never block on a prompt — and sudo-based installs can't work
+    // there anyway. The CLI is optional (scaffolding seeds via bun:sqlite);
+    // mention it and move on.
+    if (!stdin.isTTY || !stdout.isTTY || env.CI) {
+        console.log(`${dim('│')}\n${yellow('▲')}  sqlite3 CLI not found — optional; your database still works. Install it later for a db shell: ${SQLITE_URL}`);
+        return;
+    }
     const proceed = await confirm({
         initialValue: true,
-        message: 'sqlite3 CLI is required for local SQLite databases. Install now?'
+        message: 'sqlite3 CLI is optional (handy as a db shell). Install now?'
     });
     if (!proceed)
         return;

package/dist/utils/interactive.d.ts

@@ -0,0 +1,6 @@
+/** True only when a human can actually answer a clack prompt. */
+export declare const interactive: boolean;
+/** Headless safety net: without a TTY, a clack prompt blocks forever (the
+ *  Studio container spawns this CLI with stdin ignored). Any axis that would
+ *  prompt in that state is a missing flag/default — fail loudly instead. */
+export declare const orPrompt: <T>(flagHint: string, ask: () => Promise<T>) => Promise<T>;

package/dist/utils/interactive.js

@@ -0,0 +1,13 @@
+import { exit, stdin, stdout } from 'process';
+/** True only when a human can actually answer a clack prompt. */
+export const interactive = stdin.isTTY === true && stdout.isTTY === true;
+/** Headless safety net: without a TTY, a clack prompt blocks forever (the
+ *  Studio container spawns this CLI with stdin ignored). Any axis that would
+ *  prompt in that state is a missing flag/default — fail loudly instead. */
+export const orPrompt = (flagHint, ask) => {
+    if (!interactive) {
+        console.error(`create-absolutejs: cannot prompt for ${flagHint} without a TTY. Pass the flag explicitly (or use --skip for defaults).`);
+        exit(1);
+    }
+    return ask();
+};

package/dist/utils/parseCommandLineOptions.js

@@ -25,6 +25,7 @@ export const parseCommandLineOptions = () => {
             directory: { type: 'string' },
             env: { multiple: true, type: 'string' },
             'eslint+prettier': { type: 'boolean' },
+            examples: { type: 'boolean' },
             git: { type: 'boolean' },
             github: { type: 'string' },
             help: { default: false, short: 'h', type: 'boolean' },
@@ -118,12 +119,19 @@ export const parseCommandLineOptions = () => {
     else if (useBiome) {
         codeQualityTool = 'biome';
     }
+    else if (values.skip) {
+        // --skip must default EVERY prompted axis — a missing default here
+        // hangs headless callers (the Studio container) on a clack prompt.
+        codeQualityTool = 'eslint+prettier';
+    }
     else {
         codeQualityTool = undefined;
     }
     const directoryConfig = values.directory !== undefined && isDirectoryConfig(values.directory)
         ? values.directory
-        : undefined;
+        : // --skip defaults every prompted axis (headless callers hang on
+            // missing ones).
+            (values.skip ? 'default' : undefined);
     if (values.directory !== undefined && directoryConfig === undefined) {
         errors.push(`Invalid directory configuration: "${values.directory}". Expected: [ ${availableDirectoryConfigurations.join(', ')} ]`);
     }
@@ -236,6 +244,7 @@ export const parseCommandLineOptions = () => {
         validEnv.push(entry);
     }
     values.env = validEnv.length ? validEnv : undefined;
+    const includeExamples = values.examples ?? (values.skip ? true : undefined);
     const repoVisibility = values['repo-visibility'];
     const githubVisibility = repoVisibility === 'public' || repoVisibility === 'private'
         ? repoVisibility
@@ -257,6 +266,7 @@ export const parseCommandLineOptions = () => {
             : undefined,
         githubRepoUrl: normalizeRepoInput(values.repo)?.httpsUrl,
         githubVisibility,
+        includeExamples,
         initializeGitNow: values.git,
         installDependenciesNow: values.install,
         orm,

package/package.json

@@ -52,5 +52,5 @@
 		"typecheck": "bun run tsc --noEmit"
 	},
 	"type": "module",
-	"version": "0.13.7"
+	"version": "0.13.9"
 }