@lenne.tech/cli 1.13.0 → 1.14.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

@@ -27,7 +27,7 @@ const NewCommand = {
         // 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`);
@@ -420,6 +431,7 @@ const NewCommand = {
                 apiMode,
                 branch: apiBranch,
                 copyPath: apiCopy,
+                experimental,
                 frameworkMode,
                 frameworkUpstreamBranch,
                 linkPath: apiLink,
@@ -466,15 +478,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 +499,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 +528,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/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.14.0",
   "description": "lenne.Tech CLI: lt",
   "keywords": [
     "lenne.Tech",