@lenne.tech/cli 1.13.0 → 1.15.0

package/README.md

@@ -94,6 +94,37 @@ $ lt fullstack init --name myapp --framework-mode vendor --dry-run --noConfirm
 $ lt server create --name myapp --framework-mode vendor
 ```
 
+### Experimental: `--next` (nest-base)
+
+Both `lt fullstack init` and `lt server create` support an experimental
+`--next` flag that swaps the API template from
+[`nest-server-starter`](https://github.com/lenneTech/nest-server-starter)
+(MongoDB) to [`nest-base`](https://github.com/lenneTech/nest-base) — a new
+NestJS stack on **Bun + Prisma 7 + Postgres + Better-Auth** with a built-in
+`/dev` cockpit.
+
+```bash
+# experimental standalone api
+$ lt server create my-next-api --next --noConfirm
+
+# experimental fullstack (nuxt + nest-base)
+$ lt fullstack init --name my-next-app --frontend nuxt --next --noConfirm
+```
+
+When `--next` is set the CLI:
+
+- clones `nest-base` instead of `nest-server-starter`,
+- forces `--api-mode Rest` and `--framework-mode npm` (other modes are not
+  applicable to nest-base),
+- skips `nest-server-starter`-specific patching (`config.env.ts`,
+  `main.ts` Swagger setup, `meta.json`, `lt.config.json`),
+- skips the workspace install in fullstack mode — run `pnpm install` for
+  the frontend and `bun install` for the API yourself.
+
+This option is **experimental** and may change. The downstream `lt server
+module/object/addProp/test/permissions` commands target the classic
+`nest-server` layout and are not yet compatible with `nest-base`.
+
 ### Working on an existing project
 
 All `lt server …` commands (module, object, addProp, test, permissions)

package/build/commands/fullstack/init.js

@@ -21,13 +21,13 @@ const NewCommand = {
     run: (toolbox) => __awaiter(void 0, void 0, void 0, function* () {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0;
         // Retrieve the tools we need
-        const { config, filesystem, frontendHelper, git, helper, parameters, patching, print: { error, info, spin, success }, prompt: { ask, confirm }, server, strings: { kebabCase }, system, } = toolbox;
+        const { config, filesystem, frontendHelper, git, helper, parameters, patching, print: { error, info, spin, success }, prompt: { ask, confirm }, server, strings: { kebabCase }, system, template, } = toolbox;
         // Start timer
         const timer = system.startTimer();
         // Info
         info('Create a new fullstack workspace');
         // Hint for non-interactive callers (e.g. Claude Code)
-        toolbox.tools.nonInteractiveHint('lt fullstack init --name <name> --frontend <nuxt|angular> --api-mode <Rest|GraphQL|Both> --framework-mode <npm|vendor> [--framework-upstream-branch <ref>] [--dry-run] --noConfirm');
+        toolbox.tools.nonInteractiveHint('lt fullstack init --name <name> --frontend <nuxt|angular> --api-mode <Rest|GraphQL|Both> --framework-mode <npm|vendor> [--framework-upstream-branch <ref>] [--next] [--dry-run] --noConfirm');
         // Check git
         if (!(yield git.gitInstalled())) {
             return;
@@ -46,8 +46,9 @@ const NewCommand = {
         const configFrontendLink = (_v = (_u = ltConfig === null || ltConfig === void 0 ? void 0 : ltConfig.commands) === null || _u === void 0 ? void 0 : _u.fullstack) === null || _v === void 0 ? void 0 : _v.frontendLink;
         const configFrameworkMode = (_x = (_w = ltConfig === null || ltConfig === void 0 ? void 0 : ltConfig.commands) === null || _w === void 0 ? void 0 : _w.fullstack) === null || _x === void 0 ? void 0 : _x.frameworkMode;
         // Parse CLI arguments
-        const { 'api-branch': cliApiBranch, 'api-copy': cliApiCopy, 'api-link': cliApiLink, 'api-mode': cliApiMode, 'dry-run': cliDryRun, 'framework-mode': cliFrameworkMode, 'framework-upstream-branch': cliFrameworkUpstreamBranch, frontend: cliFrontend, 'frontend-branch': cliFrontendBranch, 'frontend-copy': cliFrontendCopy, 'frontend-framework-mode': cliFrontendFrameworkMode, 'frontend-link': cliFrontendLink, git: cliGit, 'git-link': cliGitLink, name: cliName, } = parameters.options;
+        const { 'api-branch': cliApiBranch, 'api-copy': cliApiCopy, 'api-link': cliApiLink, 'api-mode': cliApiMode, 'dry-run': cliDryRun, 'framework-mode': cliFrameworkMode, 'framework-upstream-branch': cliFrameworkUpstreamBranch, frontend: cliFrontend, 'frontend-branch': cliFrontendBranch, 'frontend-copy': cliFrontendCopy, 'frontend-framework-mode': cliFrontendFrameworkMode, 'frontend-link': cliFrontendLink, git: cliGit, 'git-link': cliGitLink, name: cliName, next: cliNext, } = parameters.options;
         const dryRun = cliDryRun === true || cliDryRun === 'true';
+        const experimental = cliNext === true || cliNext === 'true';
         const frameworkUpstreamBranch = typeof cliFrameworkUpstreamBranch === 'string' && cliFrameworkUpstreamBranch.length > 0
             ? cliFrameworkUpstreamBranch
             : undefined;
@@ -109,7 +110,11 @@ const NewCommand = {
         // Determine API mode with priority: CLI > config > global > interactive (default: Rest)
         const globalApiMode = config.getGlobalDefault(ltConfig, 'apiMode');
         let apiMode;
-        if (cliApiMode) {
+        if (experimental) {
+            apiMode = 'Rest';
+            info('Using experimental nest-base template (Bun + Prisma + Postgres + Better-Auth)');
+        }
+        else if (cliApiMode) {
             apiMode = cliApiMode;
         }
         else if (configApiMode) {
@@ -154,7 +159,10 @@ const NewCommand = {
         //
         // Default is still 'npm' until the vendoring pilot is fully evaluated.
         let frameworkMode;
-        if (cliFrameworkMode === 'npm' || cliFrameworkMode === 'vendor') {
+        if (experimental) {
+            frameworkMode = 'npm';
+        }
+        else if (cliFrameworkMode === 'npm' || cliFrameworkMode === 'vendor') {
             frameworkMode = cliFrameworkMode;
         }
         else if (cliFrameworkMode) {
@@ -291,7 +299,10 @@ const NewCommand = {
             info('Would execute:');
             info(`  1. git clone lt-monorepo → ${projectDir}/`);
             info(`  2. setup frontend (${frontend}) → ${projectDir}/projects/app`);
-            if (frameworkMode === 'vendor') {
+            if (experimental) {
+                info(`  3. clone nest-base (experimental) → ${projectDir}/projects/api`);
+            }
+            else if (frameworkMode === 'vendor') {
                 info(`  3. clone nest-server-starter → ${projectDir}/projects/api`);
                 info(`  4. clone @lenne.tech/nest-server${frameworkUpstreamBranch ? ` (branch/tag: ${frameworkUpstreamBranch})` : ''} → /tmp`);
                 info(`  5. vendor core/ + flatten-fix + codemod consumer imports`);
@@ -333,16 +344,46 @@ const NewCommand = {
         const ngBaseSpinner = spin(`Integrate example for ${frontend}`);
         // Remove git folder after clone
         filesystem.remove(`${projectDir}/.git`);
-        // Patch CLAUDE.md with project-specific values
-        const claudeMdPath = `${projectDir}/CLAUDE.md`;
-        if (filesystem.exists(claudeMdPath)) {
-            const frontendName = frontend === 'nuxt' ? 'Nuxt 4' : 'Angular';
-            yield patching.update(claudeMdPath, (content) => content
-                .replace(/\{\{PROJECT_NAME\}\}/g, () => name)
-                .replace(/\{\{PROJECT_DIR\}\}/g, () => projectDir)
-                .replace(/\{\{API_MODE\}\}/g, () => apiMode)
-                .replace(/\{\{FRAMEWORK_MODE\}\}/g, () => frameworkMode)
-                .replace(/\{\{FRONTEND_FRAMEWORK\}\}/g, () => frontendName));
+        // Patch root files for the project.
+        //
+        // For the classic flow we patch the cloned `lt-monorepo` CLAUDE.md with
+        // template variables. For `--next` (experimental) we replace the root
+        // README.md, CLAUDE.md, and create `.claude/QUICKSTART.md` outright,
+        // because `lt-monorepo`'s root files describe the legacy MongoDB +
+        // GraphQL stack which is explicitly out of scope for the nest-base
+        // template — leaving them in place poisons every AI agent's context.
+        if (experimental) {
+            const nextTemplateProps = { name, projectDir };
+            // Render new root files. `template.generate({ target })` overwrites
+            // anything at `target`, which is what we want — the freshly cloned
+            // monorepo's stale README/CLAUDE.md must be replaced wholesale.
+            yield template.generate({
+                props: nextTemplateProps,
+                target: `${projectDir}/README.md`,
+                template: 'next-fullstack/README.md.ejs',
+            });
+            yield template.generate({
+                props: nextTemplateProps,
+                target: `${projectDir}/CLAUDE.md`,
+                template: 'next-fullstack/CLAUDE.md.ejs',
+            });
+            yield template.generate({
+                props: nextTemplateProps,
+                target: `${projectDir}/.claude/QUICKSTART.md`,
+                template: 'next-fullstack/.claude/QUICKSTART.md.ejs',
+            });
+        }
+        else {
+            const claudeMdPath = `${projectDir}/CLAUDE.md`;
+            if (filesystem.exists(claudeMdPath)) {
+                const frontendName = frontend === 'nuxt' ? 'Nuxt 4' : 'Angular';
+                yield patching.update(claudeMdPath, (content) => content
+                    .replace(/\{\{PROJECT_NAME\}\}/g, () => name)
+                    .replace(/\{\{PROJECT_DIR\}\}/g, () => projectDir)
+                    .replace(/\{\{API_MODE\}\}/g, () => apiMode)
+                    .replace(/\{\{FRAMEWORK_MODE\}\}/g, () => frameworkMode)
+                    .replace(/\{\{FRONTEND_FRAMEWORK\}\}/g, () => frontendName));
+            }
         }
         // Always initialize git
         try {
@@ -420,6 +461,7 @@ const NewCommand = {
                 apiMode,
                 branch: apiBranch,
                 copyPath: apiCopy,
+                experimental,
                 frameworkMode,
                 frameworkUpstreamBranch,
                 linkPath: apiLink,
@@ -466,15 +508,20 @@ const NewCommand = {
             // instead.` and silently disables CVE overrides.
             (0, hoist_workspace_pnpm_config_1.hoistWorkspacePnpmConfig)({ filesystem, projectDir, subProjects: ['projects/api', 'projects/app'] });
             // Install all packages
-            const installSpinner = spin('Install all packages');
-            try {
-                const detectedPm = toolbox.pm.detect(projectDir);
-                yield system.run(`cd ${projectDir} && ${toolbox.pm.install(detectedPm)} && ${toolbox.pm.run('init', detectedPm)}`);
-                installSpinner.succeed('Successfully installed all packages');
+            if (!experimental) {
+                const installSpinner = spin('Install all packages');
+                try {
+                    const detectedPm = toolbox.pm.detect(projectDir);
+                    yield system.run(`cd ${projectDir} && ${toolbox.pm.install(detectedPm)} && ${toolbox.pm.run('init', detectedPm)}`);
+                    installSpinner.succeed('Successfully installed all packages');
+                }
+                catch (err) {
+                    installSpinner.fail(`Failed to install packages: ${err.message}`);
+                    return;
+                }
             }
-            catch (err) {
-                installSpinner.fail(`Failed to install packages: ${err.message}`);
-                return;
+            else {
+                info('Skipping workspace install — run `bun install` (api) and `pnpm install` (app) manually.');
             }
             // Post-install format pass. processApiMode (run earlier in
             // setupServerForFullstack) and convertAppCloneToVendored rewrite
@@ -482,10 +529,10 @@ const NewCommand = {
             // `pnpm run format:check` (multi-line arrays/imports after region
             // stripping, import-path rewrites that now fit single-line). The
             // formatter is only available after install, so we normalize here.
-            if (apiMode && filesystem.isDirectory(`${projectDir}/projects/api`)) {
+            if (!experimental && apiMode && filesystem.isDirectory(`${projectDir}/projects/api`)) {
                 yield toolbox.apiMode.formatProject(`${projectDir}/projects/api`);
             }
-            if (isNuxt && filesystem.isDirectory(`${projectDir}/projects/app`)) {
+            if (!experimental && isNuxt && filesystem.isDirectory(`${projectDir}/projects/app`)) {
                 yield toolbox.apiMode.formatProject(`${projectDir}/projects/app`);
             }
             // Create initial commit after everything is set up
@@ -511,9 +558,18 @@ const NewCommand = {
             success(`Generated fullstack workspace with ${frontend} in ${projectDir} with ${name} app in ${helper.msToMinutesAndSeconds(timer())}m.`);
             info('');
             info('Next:');
-            info(`  Run ${name}`);
-            info(`  $ cd ${projectDir}`);
-            info(`  $ ${toolbox.pm.run('start')}`);
+            if (experimental) {
+                info(`  $ cd ${projectDir}`);
+                info('  Frontend: cd projects/app && pnpm install');
+                info('  API:      cd projects/api && bun install');
+                info('  Configure projects/api/.env (see .env.example)');
+                info('  Start Postgres + run prisma generate / migrate');
+            }
+            else {
+                info(`  Run ${name}`);
+                info(`  $ cd ${projectDir}`);
+                info(`  $ ${toolbox.pm.run('start')}`);
+            }
             info('');
             if (!toolbox.parameters.options.fromGluegunMenu) {
                 process.exit();

package/build/commands/server/create.js

@@ -42,6 +42,13 @@ const NewCommand = {
                 { description: 'Git branch to clone from', flag: '--branch', required: false, type: 'string' },
                 { description: 'Copy from local path instead of cloning', flag: '--copy', required: false, type: 'string' },
                 { description: 'Symlink to local path instead of cloning', flag: '--link', required: false, type: 'string' },
+                {
+                    default: false,
+                    description: 'Use experimental nest-base template (Bun + Prisma + Postgres)',
+                    flag: '--next',
+                    required: false,
+                    type: 'boolean',
+                },
                 {
                     default: false,
                     description: 'Skip all interactive prompts',
@@ -77,6 +84,7 @@ const NewCommand = {
         const cliApiMode = parameters.options['api-mode'] || parameters.options.apiMode;
         const cliFrameworkMode = parameters.options['framework-mode'];
         const cliFrameworkUpstreamBranch = parameters.options['framework-upstream-branch'];
+        const experimental = parameters.options.next === true || parameters.options.next === 'true';
         // Determine noConfirm with priority: CLI > config > global > default (false)
         const noConfirm = config.getNoConfirm({
             cliValue: cliNoConfirm,
@@ -88,7 +96,7 @@ const NewCommand = {
         // Info
         info('Create a new server');
         // Hint for non-interactive callers (e.g. Claude Code)
-        toolbox.tools.nonInteractiveHint('lt server create --name <name> --api-mode <Rest|GraphQL|Both> --noConfirm');
+        toolbox.tools.nonInteractiveHint('lt server create --name <name> --api-mode <Rest|GraphQL|Both> [--next] --noConfirm');
         // Check git
         if (!(yield git.gitInstalled())) {
             return;
@@ -150,7 +158,11 @@ const NewCommand = {
         }
         // Determine API mode with priority: CLI > config > global > interactive (default: Rest)
         let apiMode;
-        if (cliApiMode) {
+        if (experimental) {
+            apiMode = 'Rest';
+            info('Using experimental nest-base template (Bun + Prisma + Postgres + Better-Auth)');
+        }
+        else if (cliApiMode) {
             apiMode = cliApiMode;
         }
         else if (configApiMode) {
@@ -184,7 +196,10 @@ const NewCommand = {
         // Determine framework consumption mode — same resolution cascade as
         // lt fullstack init: CLI flag > lt.config > interactive (default npm).
         let frameworkMode;
-        if (cliFrameworkMode === 'npm' || cliFrameworkMode === 'vendor') {
+        if (experimental) {
+            frameworkMode = 'npm';
+        }
+        else if (cliFrameworkMode === 'npm' || cliFrameworkMode === 'vendor') {
             frameworkMode = cliFrameworkMode;
         }
         else if (cliFrameworkMode) {
@@ -222,6 +237,7 @@ const NewCommand = {
             branch,
             copyPath,
             description,
+            experimental,
             frameworkMode,
             frameworkUpstreamBranch,
             linkPath,
@@ -279,36 +295,47 @@ const NewCommand = {
         }
         // Derive controller type from API mode and save project config
         const controllerType = apiMode;
-        // Create lt.config.json
-        const projectConfig = {
-            commands: {
-                server: {
-                    module: {
-                        controller: controllerType,
+        if (!experimental) {
+            // Create lt.config.json
+            const projectConfig = {
+                commands: {
+                    server: {
+                        module: {
+                            controller: controllerType,
+                        },
                     },
                 },
-            },
-            meta: {
-                apiMode,
-                version: '1.0.0',
-            },
-        };
-        const configPath = filesystem.path(projectDir, 'lt.config.json');
-        filesystem.write(configPath, projectConfig, { jsonIndent: 2 });
-        info('');
-        success(`Configuration saved to ${projectDir}/lt.config.json`);
-        info(`   API mode: ${apiMode}`);
-        info(`   Default controller type: ${controllerType}`);
+                meta: {
+                    apiMode,
+                    version: '1.0.0',
+                },
+            };
+            const configPath = filesystem.path(projectDir, 'lt.config.json');
+            filesystem.write(configPath, projectConfig, { jsonIndent: 2 });
+            info('');
+            success(`Configuration saved to ${projectDir}/lt.config.json`);
+            info(`   API mode: ${apiMode}`);
+            info(`   Default controller type: ${controllerType}`);
+        }
         // We're done, so show what to do next
         info('');
         success(`Generated ${name} server with lenne.Tech CLI ${meta.version()} in ${helper.msToMinutesAndSeconds(timer())}m.`);
         info('');
         info('Next:');
-        info('  Start database server (e.g. MongoDB)');
-        info(`  Check config: ${projectDir}/src/config.env.ts`);
-        info(`  Go to project directory: cd ${projectDir}`);
-        info(`  Run tests: ${toolbox.pm.run('test:e2e')}`);
-        info(`  Start server: ${toolbox.pm.run('start')}`);
+        if (experimental) {
+            info(`  Go to project directory: cd ${projectDir}`);
+            info('  Install dependencies: bun install');
+            info('  Configure .env (see .env.example)');
+            info('  Start Postgres + run prisma generate / migrate');
+            info('  Start server: bun run dev');
+        }
+        else {
+            info('  Start database server (e.g. MongoDB)');
+            info(`  Check config: ${projectDir}/src/config.env.ts`);
+            info(`  Go to project directory: cd ${projectDir}`);
+            info(`  Run tests: ${toolbox.pm.run('test:e2e')}`);
+            info(`  Start server: ${toolbox.pm.run('start')}`);
+        }
         info('');
         if (!toolbox.parameters.options.fromGluegunMenu) {
             process.exit();

package/build/extensions/server.js

@@ -633,13 +633,16 @@ class Server {
     setupServer(dest, options) {
         return __awaiter(this, void 0, void 0, function* () {
             const { apiMode: apiModeHelper, patching, system, template, templateHelper } = this.toolbox;
-            const { apiMode, author = '', branch, copyPath, description = '', frameworkMode = 'npm', frameworkUpstreamBranch, linkPath, name, projectDir, skipInstall = false, skipPatching = false, } = options;
+            const { apiMode, author = '', branch, copyPath, description = '', experimental = false, frameworkMode = 'npm', frameworkUpstreamBranch, linkPath, name, projectDir, skipInstall = false, skipPatching = false, } = options;
+            const repoUrl = experimental
+                ? 'https://github.com/lenneTech/nest-base.git'
+                : 'https://github.com/lenneTech/nest-server-starter.git';
             // Setup template
             const result = yield templateHelper.setup(dest, {
                 branch,
                 copyPath,
                 linkPath,
-                repoUrl: 'https://github.com/lenneTech/nest-server-starter.git',
+                repoUrl,
             });
             if (!result.success) {
                 return { method: result.method, path: result.path, success: false };
@@ -651,18 +654,20 @@ class Server {
             // Apply patches (config.env.ts, package.json, main.ts, meta.json)
             if (!skipPatching) {
                 try {
-                    // Generate README
-                    yield template.generate({
-                        props: { description, name },
-                        target: `${dest}/README.md`,
-                        template: 'nest-server-starter/README.md.ejs',
-                    });
-                    // Replace secret or private keys and update database names via AST
-                    this.patchConfigEnvTs(`${dest}/src/config.env.ts`, projectDir);
-                    // Update Swagger configuration in main.ts
-                    yield patching.update(`${dest}/src/main.ts`, (content) => content
-                        .replace(/\.setTitle\('.*?'\)/, `.setTitle('${name}')`)
-                        .replace(/\.setDescription\('.*?'\)/, `.setDescription('${description || name}')`));
+                    if (!experimental) {
+                        // Generate README
+                        yield template.generate({
+                            props: { description, name },
+                            target: `${dest}/README.md`,
+                            template: 'nest-server-starter/README.md.ejs',
+                        });
+                        // Replace secret or private keys and update database names via AST
+                        this.patchConfigEnvTs(`${dest}/src/config.env.ts`, projectDir);
+                        // Update Swagger configuration in main.ts
+                        yield patching.update(`${dest}/src/main.ts`, (content) => content
+                            .replace(/\.setTitle\('.*?'\)/, `.setTitle('${name}')`)
+                            .replace(/\.setDescription\('.*?'\)/, `.setDescription('${description || name}')`));
+                    }
                     // Update package.json
                     yield patching.update(`${dest}/package.json`, (config) => {
                         config.author = author;
@@ -674,13 +679,15 @@ class Server {
                         config.version = '0.0.1';
                         return config;
                     });
-                    // Update meta.json if exists
-                    if (this.filesystem.exists(`${dest}/src/meta`)) {
-                        yield patching.update(`${dest}/src/meta`, (config) => {
-                            config.name = name;
-                            config.description = description;
-                            return config;
-                        });
+                    if (!experimental) {
+                        // Update meta.json if exists
+                        if (this.filesystem.exists(`${dest}/src/meta`)) {
+                            yield patching.update(`${dest}/src/meta`, (config) => {
+                                config.name = name;
+                                config.description = description;
+                                return config;
+                            });
+                        }
                     }
                 }
                 catch (err) {
@@ -703,7 +710,7 @@ class Server {
             // manifest (same dance as in setupServerForFullstack).
             let standaloneVendorUpstreamDeps = {};
             let standaloneVendorCoreEssentials = [];
-            if (frameworkMode === 'vendor') {
+            if (!experimental && frameworkMode === 'vendor') {
                 try {
                     const converted = yield this.convertCloneToVendored({
                         dest,
@@ -718,7 +725,7 @@ class Server {
                 standaloneVendorCoreEssentials = this.readApiModeGraphqlEssentials(dest);
             }
             // Process API mode (before install so package.json is correct)
-            if (apiMode) {
+            if (!experimental && apiMode) {
                 try {
                     yield apiModeHelper.processApiMode(dest, apiMode);
                 }
@@ -727,7 +734,7 @@ class Server {
                 }
             }
             // Restore core essentials after processApiMode stripped them (vendor + REST only).
-            if (frameworkMode === 'vendor' && apiMode === 'Rest') {
+            if (!experimental && frameworkMode === 'vendor' && apiMode === 'Rest') {
                 try {
                     this.restoreVendorCoreEssentials({
                         dest,
@@ -740,9 +747,11 @@ class Server {
                 }
             }
             // Patch CLAUDE.md with API mode info
-            this.patchClaudeMdApiMode(dest, apiMode);
+            if (!experimental) {
+                this.patchClaudeMdApiMode(dest, apiMode);
+            }
             // Install packages
-            if (!skipInstall) {
+            if (!skipInstall && !experimental) {
                 try {
                     const { pm } = this.toolbox;
                     yield system.run(`cd "${dest}" && ${pm.install(pm.detect(dest))}`);
@@ -771,7 +780,10 @@ class Server {
     setupServerForFullstack(dest, options) {
         return __awaiter(this, void 0, void 0, function* () {
             const { apiMode: apiModeHelper, templateHelper } = this.toolbox;
-            const { apiMode, branch, copyPath, frameworkMode = 'npm', frameworkUpstreamBranch, linkPath, name, projectDir, } = options;
+            const { apiMode, branch, copyPath, experimental = false, frameworkMode = 'npm', frameworkUpstreamBranch, linkPath, name, projectDir, } = options;
+            const repoUrl = experimental
+                ? 'https://github.com/lenneTech/nest-base.git'
+                : 'https://github.com/lenneTech/nest-server-starter';
             // Both npm and vendor mode clone nest-server-starter as the base. The
             // starter ships the minimal consumer conventions a project needs
             // (src/server/common/models/persistence.model.ts, src/server/modules/user/,
@@ -791,7 +803,7 @@ class Server {
                 branch,
                 copyPath,
                 linkPath,
-                repoUrl: 'https://github.com/lenneTech/nest-server-starter',
+                repoUrl,
             });
             if (!result.success) {
                 return { method: result.method, path: result.path, success: false };
@@ -801,18 +813,33 @@ class Server {
                 return { method: 'link', path: result.path, success: true };
             }
             // Apply minimal patches for fullstack
-            try {
-                // Write meta.json
-                this.filesystem.write(`${dest}/src/meta.json`, {
-                    description: `API for ${name} app`,
-                    name: `${name}-api-server`,
-                    version: '0.0.0',
-                });
-                // Replace secret or private keys and update database names via AST
-                this.patchConfigEnvTs(`${dest}/src/config.env.ts`, projectDir);
+            if (!experimental) {
+                try {
+                    // Write meta.json
+                    this.filesystem.write(`${dest}/src/meta.json`, {
+                        description: `API for ${name} app`,
+                        name: `${name}-api-server`,
+                        version: '0.0.0',
+                    });
+                    // Replace secret or private keys and update database names via AST
+                    this.patchConfigEnvTs(`${dest}/src/config.env.ts`, projectDir);
+                }
+                catch (err) {
+                    return { method: result.method, path: dest, success: false };
+                }
             }
-            catch (err) {
-                return { method: result.method, path: dest, success: false };
+            else {
+                try {
+                    yield this.toolbox.patching.update(`${dest}/package.json`, (config) => {
+                        config.name = projectDir;
+                        config.description = `API for ${name} app`;
+                        config.version = '0.0.0';
+                        return config;
+                    });
+                }
+                catch (err) {
+                    return { method: result.method, path: dest, success: false };
+                }
             }
             // Clean up copied template artifacts
             if (result.method === 'copy') {
@@ -833,7 +860,7 @@ class Server {
             // without hard-coding package lists.
             let vendorUpstreamDeps = {};
             let vendorCoreEssentials = [];
-            if (frameworkMode === 'vendor') {
+            if (!experimental && frameworkMode === 'vendor') {
                 try {
                     const converted = yield this.convertCloneToVendored({
                         dest,
@@ -856,7 +883,7 @@ class Server {
                 vendorCoreEssentials = this.readApiModeGraphqlEssentials(dest);
             }
             // Process API mode (before install which happens at monorepo level)
-            if (apiMode) {
+            if (!experimental && apiMode) {
                 try {
                     yield apiModeHelper.processApiMode(dest, apiMode);
                 }
@@ -867,7 +894,7 @@ class Server {
             // In vendor mode + REST, re-add the graphql essentials that
             // processApiMode just stripped. Both and GraphQL keep all packages
             // by construction and don't need restoration.
-            if (frameworkMode === 'vendor' && apiMode === 'Rest') {
+            if (!experimental && frameworkMode === 'vendor' && apiMode === 'Rest') {
                 try {
                     this.restoreVendorCoreEssentials({
                         dest,
@@ -881,7 +908,9 @@ class Server {
                 }
             }
             // Patch CLAUDE.md with API mode info
-            this.patchClaudeMdApiMode(dest, apiMode);
+            if (!experimental) {
+                this.patchClaudeMdApiMode(dest, apiMode);
+            }
             return { method: result.method, path: dest, success: true };
         });
     }

package/build/extensions/tools.js

@@ -43,14 +43,25 @@ class Tools {
      * Suggests using CLI parameters instead of interactive prompts.
      * Only shows once per session.
      *
+     * Skipped when the caller already passed `--noConfirm` — they're
+     * deliberately running headless and don't need a hint to repeat the
+     * command, which would just be confusing noise (the friction-log
+     * complaint that triggered this guard).
+     *
      * @param usage - Example command with parameters, e.g. "lt fullstack init --name <name> --frontend <nuxt|angular> --noConfirm"
      */
     nonInteractiveHint(usage) {
+        var _a;
         if (this.hintShown || process.stdin.isTTY) {
             return;
         }
+        const { parameters, print } = this.toolbox;
+        const noConfirm = (_a = parameters === null || parameters === void 0 ? void 0 : parameters.options) === null || _a === void 0 ? void 0 : _a.noConfirm;
+        if (noConfirm === true || noConfirm === 'true') {
+            this.hintShown = true;
+            return;
+        }
         this.hintShown = true;
-        const { print } = this.toolbox;
         print.info(print.colors.yellow(`Hint: Non-interactive mode detected. Use parameters to skip prompts:`));
         print.info(print.colors.yellow(`  ${usage}`));
         print.info('');

package/build/templates/next-fullstack/.claude/QUICKSTART.md.ejs

@@ -0,0 +1,61 @@
+# QUICKSTART — `<%= props.name %>` workspace
+
+A fresh AI agent that just opened this workspace. Read this once, then
+switch to a subproject.
+
+## You almost certainly want a subproject
+
+| If you are doing                                    | Go to                                                                   |
+| --------------------------------------------------- | ----------------------------------------------------------------------- |
+| Backend / API / DB / Prisma / auth / permissions    | `cd projects/api` → [`projects/api/.claude/QUICKSTART.md`](../projects/api/.claude/QUICKSTART.md) |
+| Frontend / Nuxt / pages / components                | `cd projects/app` → its `README.md` and `CLAUDE.md`                     |
+| Cross-project work (deploy, CI, monorepo tooling)   | this root level                                                         |
+
+The moment you're touching domain code or framework conventions, you
+belong in a subproject. This root level is just the workspace shell.
+
+## Bring up the dev environment
+
+```bash
+# API
+cd projects/api
+bun install
+bun run setup            # generates .env with strong random secrets
+docker compose up -d postgres
+bun run prepare:schema   # only needed before first migrate / when feature flags change
+bun run prisma:generate
+bun run prisma:migrate
+bun run dev              # boots Postgres if needed, opens the Dev Hub at /dev
+
+# Frontend (in another shell)
+cd projects/app
+pnpm install
+pnpm dev
+```
+
+If `bun run prisma:migrate` fails with a P1000 auth error after
+re-running `bun run setup`, the Postgres volume still holds the old
+password — run `docker compose down -v && docker compose up -d
+postgres` to wipe it, then migrate again.
+
+## Stack
+
+|          | API                | App                |
+| -------- | ------------------ | ------------------ |
+| Runtime  | Bun 1.x            | Node 22            |
+| Framework| NestJS 11          | Nuxt 4             |
+| Database | Postgres 18        | —                  |
+| ORM      | Prisma 7           | —                  |
+| Auth     | Better-Auth        | —                  |
+| Lang     | TypeScript strict  | TypeScript strict  |
+
+For everything else (architecture, conventions, gates, debugging),
+switch to the subproject.
+
+## Don'ts
+
+- Don't add repo conventions in this root — they belong in the
+  subproject they apply to.
+- Don't introduce GraphQL / MongoDB / Mongoose / vendor-mode
+  framework cores. Those are explicitly out of scope for `--next`
+  workspaces; see the API's `docs/architecture.md` for context.

package/build/templates/next-fullstack/CLAUDE.md.ejs

@@ -0,0 +1,45 @@
+# CLAUDE.md — `<%= props.name %>` workspace
+
+This is a fullstack workspace with separate Claude Code contexts per
+subproject. Pick the right one for your task and read its `CLAUDE.md`
+first — that's where the conventions, architecture, and quickstart
+live.
+
+## Routing
+
+| Task                                           | Where to read                                                       |
+| ---------------------------------------------- | ------------------------------------------------------------------- |
+| Backend / API / database / Prisma migrations   | [`projects/api/CLAUDE.md`](./projects/api/CLAUDE.md)                |
+| Frontend / Nuxt / pages / components           | [`projects/app/CLAUDE.md`](./projects/app/CLAUDE.md)                |
+| 60-second agent onboarding                     | [`.claude/QUICKSTART.md`](./.claude/QUICKSTART.md)                  |
+
+## Tech stack at a glance
+
+- **API** — Bun 1.x · NestJS 11 · Prisma 7 · Postgres 18 · Better-Auth · REST + OpenAPI 3.1
+- **App** — Nuxt 4 · Vue 3 · TypeScript
+
+Detailed conventions live in the subproject `CLAUDE.md` files. Don't
+add convention rules to this root file — they belong in the subproject
+they apply to.
+
+## Out of scope (do not add to either subproject)
+
+- GraphQL / Apollo
+- Mongoose / MongoDB
+- Vendor mode for the framework core (the `--next` template ships
+  `nest-base` directly, no `@lenne.tech/nest-server` npm dependency)
+- The legacy `@Restricted` / `@Roles` decorators
+
+These are explicitly removed in the `nest-base` template and a real
+project should never reintroduce them. See
+[`projects/api/docs/architecture.md`](./projects/api/docs/architecture.md)
+"Out of scope" for the rationale.
+
+## When you open this repo cold
+
+1. Identify whether the task is backend, frontend, or cross-project.
+2. `cd projects/api` (or `projects/app`) and read its `CLAUDE.md`.
+3. Run the subproject's quality gates before committing.
+4. Cross-project changes (Docker compose, repo hygiene, deploy config)
+   stay at this root and follow each subproject's conventions when they
+   touch its files.

package/build/templates/next-fullstack/README.md.ejs

@@ -0,0 +1,48 @@
+# <%= props.name %>
+
+Fullstack workspace generated by `lt fullstack init --next`. The API is
+the next-generation [`nest-base`](https://github.com/lenneTech/nest-base)
+template (Bun + Prisma + Postgres + Better-Auth + REST). The app is a
+Nuxt 4 frontend.
+
+This root README intentionally stays minimal — each subproject has its
+own `README.md` / `CLAUDE.md` / `.claude/` with the detail you actually
+need while working in it.
+
+## Layout
+
+- [`projects/api/`](./projects/api/) — NestJS backend (Bun · Prisma 7 · Postgres 18 · Better-Auth)
+- [`projects/app/`](./projects/app/) — Nuxt 4 frontend
+- [`.claude/QUICKSTART.md`](./.claude/QUICKSTART.md) — agent routing card
+
+## Quick start
+
+### API (Bun + Prisma + Postgres)
+
+```bash
+cd projects/api
+bun install
+bun run setup            # generate .env with strong random secrets
+docker compose up -d postgres
+bun run prepare:schema   # concatenate active feature schemas
+bun run prisma:generate
+bun run prisma:migrate
+bun run dev              # boots Postgres if needed, opens the Dev Hub
+```
+
+The Dev Hub is at `http://localhost:3000/dev`. See
+[`projects/api/README.md`](./projects/api/README.md) for the full tour.
+
+### Frontend (Nuxt 4)
+
+```bash
+cd projects/app
+pnpm install
+pnpm dev
+```
+
+See [`projects/app/README.md`](./projects/app/README.md).
+
+## License
+
+MIT

package/docs/LT-ECOSYSTEM-GUIDE.md

@@ -117,6 +117,7 @@ Flags:
 - `--frontend-framework-mode npm|vendor` — Frontend mode
 - `--framework-upstream-branch <tag>` — Specific nest-server version for vendor
 - `--dry-run` — Show plan without making changes
+- `--next` — **Experimental:** clone [`nest-base`](https://github.com/lenneTech/nest-base) (Bun + Prisma 7 + Postgres + Better-Auth) for the API instead of `nest-server-starter`. Forces `--api-mode Rest`, `--framework-mode npm`, and skips workspace install (run `pnpm install` for app and `bun install` for api manually). Downstream `lt server module/object/addProp/test/permissions` are NOT compatible with the resulting layout.
 
 ---
 

package/docs/commands.md

@@ -79,13 +79,16 @@ lt server create [name] [options]
 |--------|-------------|
 | `--description <text>` | Project description |
 | `--author <name>` | Author name |
+| `--api-mode <Rest\|GraphQL\|Both>` | API mode (ignored with `--next`) |
+| `--framework-mode <npm\|vendor>` | Framework consumption mode (ignored with `--next`) |
 | `--branch <branch>` / `-b` | Branch of nest-server-starter to use as template |
 | `--copy <path>` / `-c` | Copy from local template directory instead of cloning |
 | `--link <path>` | Symlink to local template directory (fastest, changes affect original) |
 | `--git` | Initialize git repository |
+| `--next` | **Experimental:** clone [`nest-base`](https://github.com/lenneTech/nest-base) (Bun + Prisma 7 + Postgres + Better-Auth) instead of `nest-server-starter`. Skips API-mode / vendor-mode / install / lt.config.json processing. |
 | `--noConfirm` | Skip confirmation prompts |
 
-**CLAUDE.md Patching:** If the project contains a `CLAUDE.md`, the generic API mode description is replaced with the selected mode. In single-mode projects (`Rest` or `GraphQL`), the "API Mode System" documentation section is condensed to a brief note.
+**CLAUDE.md Patching:** If the project contains a `CLAUDE.md`, the generic API mode description is replaced with the selected mode. In single-mode projects (`Rest` or `GraphQL`), the "API Mode System" documentation section is condensed to a brief note. Skipped when `--next` is used.
 
 **Configuration:** `commands.server.create.*`, `defaults.author`, `defaults.noConfirm`
 
@@ -532,6 +535,7 @@ lt fullstack init [options]
 | `--framework-mode <mode>` | Backend framework consumption mode: `npm` (classic) or `vendor` (pilot, core copied to `src/core/`) |
 | `--framework-upstream-branch <ref>` | Upstream `nest-server` branch/tag to vendor from (only with `--framework-mode vendor`) |
 | `--frontend-framework-mode <mode>` | Frontend framework consumption mode: `npm` or `vendor` (nuxt-extensions copied to `app/core/`) |
+| `--next` | **Experimental:** clone [`nest-base`](https://github.com/lenneTech/nest-base) (Bun + Prisma 7 + Postgres + Better-Auth) for the API instead of `nest-server-starter`. Forces `--api-mode Rest` and `--framework-mode npm`, skips workspace install (run `pnpm install` for app and `bun install` for api manually). |
 | `--dry-run` | Print the resolved plan without making any changes |
 | `--git` | Push initial commit to remote repository (git is always initialized) |
 | `--git-link <url>` | Git remote repository URL (required when `--git` is true) |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lenne.tech/cli",
-  "version": "1.13.0",
+  "version": "1.15.0",
   "description": "lenne.Tech CLI: lt",
   "keywords": [
     "lenne.Tech",