rapidkit 0.11.1 → 0.11.2

package/README.md

@@ -335,7 +335,7 @@ npx rapidkit my-workspace --test-mode
 4. **Navigate and run**:
    ```bash
    cd api-service
-   rapidkit run dev
+   rapidkit dev
    ```
 
 5. **Create more projects** (from workspace root):
@@ -421,7 +421,7 @@ After setting up your demo project:
 ## Related Projects
 
 - **RapidKit Python** - The core framework (coming soon to PyPI)
-- **RapidKit Marketplace** - Browse and share modules (https://rapidkit.dev)
+- **RapidKit Marketplace** - Browse and share modules (https://rapidkit.top)
 - **GitHub**: https://github.com/getrapidkit
 
 ## Contributing
@@ -481,7 +481,7 @@ MIT
 ## Support
 
 - 🐛 Report issues: [GitHub Issues](https://github.com/getrapidkit/rapidkit-npm/issues)
-- 📚 Docs: https://rapidkit.dev
+- 📚 Docs: https://rapidkit.top
 - 💬 Community: Coming soon
 
 ---

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import {Command}from'commander';import i from'chalk';import {readFileSync,promises}from'fs';import*as h from'fs-extra';import y,{dirname,join}from'path';import oe from'inquirer';import W from'ora';import {execa}from'execa';import ee from'os';import ce from'nunjucks';import {fileURLToPath}from'url';import je from'validate-npm-package-name';var G=class{debugEnabled=false;setDebug(e){this.debugEnabled=e;}debug(e,...o){this.debugEnabled&&console.log(i.gray(`[DEBUG] ${e}`),...o);}info(e,...o){console.log(i.blue(e),...o);}success(e,...o){console.log(i.green(e),...o);}warn(e,...o){console.log(i.yellow(e),...o);}error(e,...o){console.error(i.red(e),...o);}step(e,o,r){console.log(i.cyan(`
+import {Command}from'commander';import i from'chalk';import {readFileSync,promises}from'fs';import*as h from'fs-extra';import y,{dirname,join}from'path';import oe from'inquirer';import W from'ora';import {execa}from'execa';import ee from'os';import le from'nunjucks';import {fileURLToPath}from'url';import je from'validate-npm-package-name';var G=class{debugEnabled=false;setDebug(e){this.debugEnabled=e;}debug(e,...o){this.debugEnabled&&console.log(i.gray(`[DEBUG] ${e}`),...o);}info(e,...o){console.log(i.blue(e),...o);}success(e,...o){console.log(i.green(e),...o);}warn(e,...o){console.log(i.yellow(e),...o);}error(e,...o){console.error(i.red(e),...o);}step(e,o,r){console.log(i.cyan(`
 [${e}/${o}]`),i.white(r));}},s=new G;var te=".rapidkitrc.json";async function z(){let t=y.join(ee.homedir(),te);try{let e=await promises.readFile(t,"utf-8"),o=JSON.parse(e);return s.debug(`Loaded config from ${t}`),o}catch{return s.debug("No user config found, using defaults"),{}}}function F(t){return process.env.RAPIDKIT_DEV_PATH||t.testRapidKitPath||void 0}var g=class extends Error{constructor(o,r,n){super(o);this.code=r;this.details=n;this.name="RapidKitError",Error.captureStackTrace(this,this.constructor);}},b=class extends g{constructor(e,o){let r=o?`Python ${e}+ required, found ${o}`:`Python ${e}+ not found`;super(r,"PYTHON_NOT_FOUND","Please install Python from https://www.python.org/downloads/");}},$=class extends g{constructor(){super("Poetry is not installed","POETRY_NOT_FOUND","Install Poetry from https://python-poetry.org/docs/#installation");}},N=class extends g{constructor(){super("pipx is not installed","PIPX_NOT_FOUND","Install pipx from https://pypa.github.io/pipx/installation/");}},T=class extends g{constructor(e){super(`Directory "${e}" already exists`,"DIRECTORY_EXISTS","Please choose a different name or remove the existing directory");}},k=class extends g{constructor(e,o){super(`Invalid project name: "${e}"`,"INVALID_PROJECT_NAME",o);}},j=class extends g{constructor(e,o){let r=`Installation failed at: ${e}`,n=`${o.message}
 
 Troubleshooting:
@@ -8,20 +8,20 @@ Troubleshooting:
 - Try running with --debug flag for more details`;super(r,"INSTALLATION_ERROR",n);}},x=class extends g{constructor(){super("RapidKit Python package is not yet available on PyPI","RAPIDKIT_NOT_AVAILABLE",`Available options:
   1. Demo mode: npx rapidkit my-workspace --demo
   2. Test mode: npx rapidkit my-workspace --test-mode (requires local RapidKit)
-  3. Wait for official PyPI release (coming soon)`);}};async function U(t,e){let{skipGit:o=false,testMode:r=false,demoMode:n=false,dryRun:m=false,userConfig:p={}}=e,a=t,l=y.resolve(process.cwd(),a);if(await h.pathExists(l))throw new T(a);if(m){await le(l,a,n,p);return}if(n){await se(l,a,o);return}let f=await oe.prompt([{type:"list",name:"pythonVersion",message:"Select Python version for RapidKit:",choices:["3.10","3.11","3.12"],default:p.pythonVersion||"3.11"},{type:"list",name:"installMethod",message:"How would you like to install RapidKit?",choices:[{name:"\u{1F3AF} Poetry (Recommended - includes virtual env)",value:"poetry"},{name:"\u{1F4E6} pip with venv (Standard)",value:"venv"},{name:"\u{1F527} pipx (Global isolated install)",value:"pipx"}],default:p.defaultInstallMethod||"poetry"}]);s.step(1,3,"Setting up RapidKit environment");let u=W("Creating directory").start();try{if(await h.ensureDir(l),u.succeed("Directory created"),f.installMethod==="poetry"?await ie(l,f.pythonVersion,u,r,p):f.installMethod==="venv"?await re(l,f.pythonVersion,u,r,p):await ne(l,u,r,p),await ae(l,f.installMethod),u.succeed("RapidKit environment ready!"),!e.skipGit){u.start("Initializing git repository");try{await execa("git",["init"],{cwd:l}),await h.outputFile(y.join(l,".gitignore"),`.venv/
+  3. Wait for official PyPI release (coming soon)`);}};async function U(t,e){let{skipGit:o=false,testMode:r=false,demoMode:n=false,dryRun:m=false,userConfig:p={}}=e,a=t,c=y.resolve(process.cwd(),a);if(await h.pathExists(c))throw new T(a);if(m){await ce(c,a,n,p);return}if(n){await se(c,a,o);return}let f=await oe.prompt([{type:"list",name:"pythonVersion",message:"Select Python version for RapidKit:",choices:["3.10","3.11","3.12"],default:p.pythonVersion||"3.11"},{type:"list",name:"installMethod",message:"How would you like to install RapidKit?",choices:[{name:"\u{1F3AF} Poetry (Recommended - includes virtual env)",value:"poetry"},{name:"\u{1F4E6} pip with venv (Standard)",value:"venv"},{name:"\u{1F527} pipx (Global isolated install)",value:"pipx"}],default:p.defaultInstallMethod||"poetry"}]);s.step(1,3,"Setting up RapidKit environment");let u=W("Creating directory").start();try{if(await h.ensureDir(c),u.succeed("Directory created"),f.installMethod==="poetry"?await ie(c,f.pythonVersion,u,r,p):f.installMethod==="venv"?await re(c,f.pythonVersion,u,r,p):await ne(c,u,r,p),await ae(c,f.installMethod),u.succeed("RapidKit environment ready!"),!e.skipGit){u.start("Initializing git repository");try{await execa("git",["init"],{cwd:c}),await h.outputFile(y.join(c,".gitignore"),`.venv/
 __pycache__/
 *.pyc
 .env
 .rapidkit-workspace/
-`,"utf-8"),await execa("git",["add","."],{cwd:l}),await execa("git",["commit","-m","Initial commit: RapidKit environment"],{cwd:l}),u.succeed("Git repository initialized");}catch{u.warn("Could not initialize git repository");}}if(console.log(i.green(`
+`,"utf-8"),await execa("git",["add","."],{cwd:c}),await execa("git",["commit","-m","Initial commit: RapidKit environment"],{cwd:c}),u.succeed("Git repository initialized");}catch{u.warn("Could not initialize git repository");}}if(console.log(i.green(`
 \u2728 RapidKit environment created successfully!
-`)),console.log(i.cyan("\u{1F4C2} Location:"),i.white(l)),console.log(i.cyan(`\u{1F680} Get started:
-`)),console.log(i.white(`   cd ${a}`)),f.installMethod==="poetry"){let v="source $(poetry env info --path)/bin/activate";try{let{stdout:C}=await execa("poetry",["--version"]),D=C.match(/Poetry.*?(\d+)\.(\d+)/);D&&(parseInt(D[1])>=2?v="source $(poetry env info --path)/bin/activate":v="poetry shell");}catch{}console.log(i.white(`   ${v}  # Or: poetry run rapidkit`)),console.log(i.white("   rapidkit create  # Interactive mode")),console.log(i.white("   cd <project-name> && poetry install && rapidkit run dev"));}else f.installMethod==="venv"?(console.log(i.white("   source .venv/bin/activate  # On Windows: .venv\\Scripts\\activate")),console.log(i.white("   rapidkit create  # Interactive mode")),console.log(i.white("   cd <project-name> && pip install -r requirements.txt && rapidkit run dev"))):(console.log(i.white("   rapidkit create  # Interactive mode")),console.log(i.white("   cd <project-name> && rapidkit run dev")));console.log(i.white(`
+`)),console.log(i.cyan("\u{1F4C2} Location:"),i.white(c)),console.log(i.cyan(`\u{1F680} Get started:
+`)),console.log(i.white(`   cd ${a}`)),f.installMethod==="poetry"){let v="source $(poetry env info --path)/bin/activate";try{let{stdout:C}=await execa("poetry",["--version"]),D=C.match(/Poetry.*?(\d+)\.(\d+)/);D&&(parseInt(D[1])>=2?v="source $(poetry env info --path)/bin/activate":v="poetry shell");}catch{}console.log(i.white(`   ${v}  # Or: poetry run rapidkit`)),console.log(i.white("   rapidkit create  # Interactive mode")),console.log(i.white("   cd <project-name> && rapidkit init && rapidkit dev"));}else f.installMethod==="venv"?(console.log(i.white("   source .venv/bin/activate  # On Windows: .venv\\Scripts\\activate")),console.log(i.white("   rapidkit create  # Interactive mode")),console.log(i.white("   cd <project-name> && rapidkit init && rapidkit dev"))):(console.log(i.white("   rapidkit create  # Interactive mode")),console.log(i.white("   cd <project-name> && rapidkit init && rapidkit dev")));console.log(i.white(`
 \u{1F4A1} For more information, check the README.md file.`)),console.log(i.cyan(`
-\u{1F4DA} RapidKit commands:`)),console.log(i.white("   rapidkit create          - Create a new project (interactive)")),console.log(i.white("   rapidkit run dev         - Run development server")),console.log(i.white("   rapidkit add module <name> - Add a module (e.g., settings)")),console.log(i.white("   rapidkit list            - List available kits")),console.log(i.white("   rapidkit modules         - List available modules")),console.log(i.white(`   rapidkit --help          - Show all commands
+\u{1F4DA} RapidKit commands:`)),console.log(i.white("   rapidkit create          - Create a new project (interactive)")),console.log(i.white("   rapidkit dev             - Run development server")),console.log(i.white("   rapidkit add module <name> - Add a module (e.g., settings)")),console.log(i.white("   rapidkit list            - List available kits")),console.log(i.white("   rapidkit modules         - List available modules")),console.log(i.white(`   rapidkit --help          - Show all commands
 `));}catch(v){u.fail("Failed to create RapidKit environment"),console.error(i.red(`
-\u274C Error:`),v);try{await h.remove(l);}catch{}process.exit(1);}}async function ie(t,e,o,r,n){o.start("Checking Poetry installation");try{await execa("poetry",["--version"]),o.succeed("Poetry found");}catch{throw new $}o.start("Initializing Poetry project"),await execa("poetry",["init","--no-interaction","--python",`^${e}`],{cwd:t});let m=y.join(t,"pyproject.toml"),a=(await promises.readFile(m,"utf-8")).replace("[tool.poetry]",`[tool.poetry]
-package-mode = false`);if(await promises.writeFile(m,a,"utf-8"),o.succeed("Poetry project initialized"),o.start("Installing RapidKit"),r){let l=F(n||{});if(!l)throw new j("Test mode installation",new Error("No local RapidKit path configured. Set RAPIDKIT_DEV_PATH environment variable."));s.debug(`Installing from local path: ${l}`),o.text="Installing RapidKit from local path (test mode)",await execa("poetry",["add",l],{cwd:t});}else {o.text="Installing RapidKit from PyPI";try{await execa("poetry",["add","rapidkit"],{cwd:t});}catch{throw new x}}o.succeed("RapidKit installed");}async function re(t,e,o,r,n){o.start(`Checking Python ${e}`);let m="python3";try{let{stdout:a}=await execa(m,["--version"]),l=a.match(/Python (\d+\.\d+)/)?.[1];if(l&&parseFloat(l)<parseFloat(e))throw new b(e,l);o.succeed(`Python ${l} found`);}catch(a){throw a instanceof b?a:new b(e)}o.start("Creating virtual environment"),await execa(m,["-m","venv",".venv"],{cwd:t}),o.succeed("Virtual environment created"),o.start("Installing RapidKit");let p=y.join(t,".venv","bin","pip");if(await execa(p,["install","--upgrade","pip"],{cwd:t}),r){let a=F(n||{});if(!a)throw new j("Test mode installation",new Error("No local RapidKit path configured. Set RAPIDKIT_DEV_PATH environment variable."));s.debug(`Installing from local path: ${a}`),o.text="Installing RapidKit from local path (test mode)",await execa(p,["install","-e",a],{cwd:t});}else {o.text="Installing RapidKit from PyPI";try{await execa(p,["install","rapidkit"],{cwd:t});}catch{throw new x}}o.succeed("RapidKit installed");}async function ne(t,e,o,r){e.start("Checking pipx installation");try{await execa("pipx",["--version"]),e.succeed("pipx found");}catch{throw new N}if(e.start("Installing RapidKit globally with pipx"),o){let n=F(r||{});if(!n)throw new j("Test mode installation",new Error("No local RapidKit path configured. Set RAPIDKIT_DEV_PATH environment variable."));s.debug(`Installing from local path: ${n}`),e.text="Installing RapidKit from local path (test mode)",await execa("pipx",["install","-e",n]);}else {e.text="Installing RapidKit from PyPI";try{await execa("pipx",["install","rapidkit"]);}catch{throw new x}}e.succeed("RapidKit installed globally"),await h.outputFile(y.join(t,".rapidkit-global"),`RapidKit installed globally with pipx
+\u274C Error:`),v);try{await h.remove(c);}catch{}process.exit(1);}}async function ie(t,e,o,r,n){o.start("Checking Poetry installation");try{await execa("poetry",["--version"]),o.succeed("Poetry found");}catch{throw new $}o.start("Initializing Poetry project"),await execa("poetry",["init","--no-interaction","--python",`^${e}`],{cwd:t});let m=y.join(t,"pyproject.toml"),a=(await promises.readFile(m,"utf-8")).replace("[tool.poetry]",`[tool.poetry]
+package-mode = false`);if(await promises.writeFile(m,a,"utf-8"),o.succeed("Poetry project initialized"),o.start("Installing RapidKit"),r){let c=F(n||{});if(!c)throw new j("Test mode installation",new Error("No local RapidKit path configured. Set RAPIDKIT_DEV_PATH environment variable."));s.debug(`Installing from local path: ${c}`),o.text="Installing RapidKit from local path (test mode)",await execa("poetry",["add",c],{cwd:t});}else {o.text="Installing RapidKit from PyPI";try{await execa("poetry",["add","rapidkit"],{cwd:t});}catch{throw new x}}o.succeed("RapidKit installed");}async function re(t,e,o,r,n){o.start(`Checking Python ${e}`);let m="python3";try{let{stdout:a}=await execa(m,["--version"]),c=a.match(/Python (\d+\.\d+)/)?.[1];if(c&&parseFloat(c)<parseFloat(e))throw new b(e,c);o.succeed(`Python ${c} found`);}catch(a){throw a instanceof b?a:new b(e)}o.start("Creating virtual environment"),await execa(m,["-m","venv",".venv"],{cwd:t}),o.succeed("Virtual environment created"),o.start("Installing RapidKit");let p=y.join(t,".venv","bin","pip");if(await execa(p,["install","--upgrade","pip"],{cwd:t}),r){let a=F(n||{});if(!a)throw new j("Test mode installation",new Error("No local RapidKit path configured. Set RAPIDKIT_DEV_PATH environment variable."));s.debug(`Installing from local path: ${a}`),o.text="Installing RapidKit from local path (test mode)",await execa(p,["install","-e",a],{cwd:t});}else {o.text="Installing RapidKit from PyPI";try{await execa(p,["install","rapidkit"],{cwd:t});}catch{throw new x}}o.succeed("RapidKit installed");}async function ne(t,e,o,r){e.start("Checking pipx installation");try{await execa("pipx",["--version"]),e.succeed("pipx found");}catch{throw new N}if(e.start("Installing RapidKit globally with pipx"),o){let n=F(r||{});if(!n)throw new j("Test mode installation",new Error("No local RapidKit path configured. Set RAPIDKIT_DEV_PATH environment variable."));s.debug(`Installing from local path: ${n}`),e.text="Installing RapidKit from local path (test mode)",await execa("pipx",["install","-e",n]);}else {e.text="Installing RapidKit from PyPI";try{await execa("pipx",["install","rapidkit"]);}catch{throw new x}}e.succeed("RapidKit installed globally"),await h.outputFile(y.join(t,".rapidkit-global"),`RapidKit installed globally with pipx
 `,"utf-8");}async function ae(t,e){let r=`# RapidKit Workspace
 
 This directory contains a RapidKit development environment.
@@ -59,14 +59,14 @@ Interactive mode will guide you through selecting a kit and configuring your pro
 
 \`\`\`bash
 cd my-project
-# Install dependencies:
-poetry install
+# Install dependencies (preferred):
+rapidkit init
 
-# Run the server (simplest way):
-rapidkit run dev
+# Run the server (project-aware):
+rapidkit dev
 
-# Or with poetry run:
-poetry run rapidkit run dev
+# Or with poetry run (manual / advanced):
+poetry run rapidkit dev
 
 # Or manually:
 uvicorn src.main:app --reload
@@ -88,7 +88,7 @@ rapidkit modules list
 
 - \`rapidkit create\` - Create a new project (interactive)
 - \`rapidkit create project <kit> <name>\` - Create project with specific kit
-- \`rapidkit run dev\` - Run development server
+- \`rapidkit dev\` - Run development server
 - \`rapidkit add module <name>\` - Add a module (e.g., \`rapidkit add module settings\`)
 - \`rapidkit list\` - List available kits
 - \`rapidkit modules\` - List available modules
@@ -98,7 +98,7 @@ rapidkit modules list
 
 ## RapidKit Documentation
 
-For full documentation, visit: [RapidKit Docs](https://rapidkit.dev) *(or appropriate URL)*
+For full documentation, visit: [RapidKit Docs](https://rapidkit.top) *(or appropriate URL)*
 
 ## Workspace Structure
 
@@ -210,7 +210,7 @@ Each generated demo project contains:
 1. **Explore the Generated Code** - Check out \`src/main.py\` and \`src/routing/\`
 2. **Add Routes** - Create new endpoints in \`src/routing/\`
 3. **Install Full RapidKit** - For advanced features: \`pipx install rapidkit\`
-4. **Read the Documentation** - Visit [RapidKit Docs](https://rapidkit.dev)
+4. **Read the Documentation** - Visit [RapidKit Docs](https://rapidkit.top)
 
 ## \u26A0\uFE0F Demo Mode Limitations
 
@@ -261,7 +261,7 @@ __pycache__/
 `,"utf-8"),await execa("git",["add","."],{cwd:t}),await execa("git",["commit","-m","Initial commit: Demo workspace"],{cwd:t}),r.succeed("Git repository initialized");}catch{r.warn("Could not initialize git repository");}}console.log(i.green(`
 \u2728 Demo workspace created successfully!
 `)),console.log(i.cyan("\u{1F4C2} Location:"),i.white(t)),console.log(i.cyan(`\u{1F680} Get started:
-`)),console.log(i.white(`   cd ${e}`)),console.log(i.white("   node generate-demo.js my-api")),console.log(i.white("   cd my-api")),console.log(i.white("   poetry install")),console.log(i.white("   poetry run python -m src.main")),console.log(),console.log(i.yellow("\u{1F4A1} Note:"),"This is a demo workspace. For full RapidKit features:"),console.log(i.cyan("   pipx install rapidkit")),console.log();}catch(n){throw r.fail("Failed to create demo workspace"),n}}async function le(t,e,o,r){console.log(i.cyan(`
+`)),console.log(i.white(`   cd ${e}`)),console.log(i.white("   node generate-demo.js my-api")),console.log(i.white("   cd my-api")),console.log(i.white("   poetry install")),console.log(i.white("   poetry run python -m src.main")),console.log(),console.log(i.yellow("\u{1F4A1} Note:"),"This is a demo workspace. For full RapidKit features:"),console.log(i.cyan("   pipx install rapidkit")),console.log();}catch(n){throw r.fail("Failed to create demo workspace"),n}}async function ce(t,e,o,r){console.log(i.cyan(`
 \u{1F50D} Dry-run mode - showing what would be created:
 `)),console.log(i.white("\u{1F4C2} Project path:"),t),console.log(i.white("\u{1F4E6} Project type:"),o?"Demo workspace":"Full RapidKit environment"),o?(console.log(i.white(`
 \u{1F4DD} Files to create:`)),console.log(i.gray("  - package.json")),console.log(i.gray("  - generate-demo.js (project generator)")),console.log(i.gray("  - README.md")),console.log(i.gray("  - .gitignore")),console.log(i.white(`
@@ -270,7 +270,7 @@ __pycache__/
 \u{1F4DD} Files to create:`)),console.log(i.gray("  - pyproject.toml (Poetry) or .venv/ (venv)")),console.log(i.gray("  - README.md")),console.log(i.gray("  - .gitignore")),console.log(i.white(`
 \u{1F3AF} Next steps after creation:`)),console.log(i.gray("  1. Install RapidKit Python package")),console.log(i.gray("  2. Create projects with rapidkit CLI")),console.log(i.gray("  3. Add modules and customize"))),console.log(i.white(`
 \u{1F4A1} To proceed with actual creation, run without --dry-run flag
-`));}var me=fileURLToPath(import.meta.url),ge=y.dirname(me);async function Y(t,e){let o=W("Generating FastAPI demo project...").start();try{let r=y.resolve(ge,".."),n=y.join(r,"templates","kits","fastapi-standard"),m=ce.configure(n,{autoescape:!1,trimBlocks:!0,lstripBlocks:!0}),p={project_name:e.project_name,author:e.author||"RapidKit User",description:e.description||"FastAPI service generated with RapidKit",app_version:e.app_version||"0.1.0",license:e.license||"MIT"},a=["src/main.py.j2","src/__init__.py.j2","src/cli.py.j2","src/routing/__init__.py.j2","src/routing/health.py.j2","src/modules/__init__.py.j2","tests/__init__.py.j2","README.md.j2","pyproject.toml.j2"];for(let f of a){let u=y.join(n,f),v=await promises.readFile(u,"utf-8"),C=m.renderString(v,p),D=f.replace(/\.j2$/,""),O=y.join(t,D);await promises.mkdir(y.dirname(O),{recursive:!0}),await promises.writeFile(O,C);}await promises.writeFile(y.join(t,".gitignore"),`# Python
+`));}var me=fileURLToPath(import.meta.url),ge=y.dirname(me);async function Y(t,e){let o=W("Generating FastAPI demo project...").start();try{let r=y.resolve(ge,".."),n=y.join(r,"templates","kits","fastapi-standard"),m=le.configure(n,{autoescape:!1,trimBlocks:!0,lstripBlocks:!0}),p={project_name:e.project_name,author:e.author||"RapidKit User",description:e.description||"FastAPI service generated with RapidKit",app_version:e.app_version||"0.1.0",license:e.license||"MIT"},a=["src/main.py.j2","src/__init__.py.j2","src/cli.py.j2","src/routing/__init__.py.j2","src/routing/health.py.j2","src/modules/__init__.py.j2","tests/__init__.py.j2","README.md.j2","pyproject.toml.j2"];for(let f of a){let u=y.join(n,f),v=await promises.readFile(u,"utf-8"),C=m.renderString(v,p),D=f.replace(/\.j2$/,""),O=y.join(t,D);await promises.mkdir(y.dirname(O),{recursive:!0}),await promises.writeFile(O,C);}await promises.writeFile(y.join(t,".gitignore"),`# Python
 __pycache__/
 *.py[cod]
 *$py.class

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rapidkit",
-  "version": "0.11.1",
+  "version": "0.11.2",
   "type": "module",
   "description": "Create RapidKit projects with a single command - The official CLI for RapidKit framework",
   "keywords": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rapidkit",
-  "version": "0.11.1",
+  "version": "0.11.2",
   "type": "module",
   "description": "Create RapidKit projects with a single command - The official CLI for RapidKit framework",
   "keywords": [

package/templates/kits/fastapi-standard/README.md.j2

@@ -5,16 +5,17 @@ A minimal FastAPI service generated with the **FastAPI Standard Kit**. All domai
 ## Quick start
 
 ```bash
-poetry install
-poetry run dev
+rapidkit init  # bootstrap the project (preferred)
+rapidkit dev
 ```
 
 ## Available commands
 
 ```bash
-poetry run dev      # 🚀 Start development server with hot reload
-poetry run start    # ⚡ Start production server
-poetry run build    # 📦 Build project for production
+rapidkit init       # 🔧 Bootstrap the project (create local launcher & install deps)
+rapidkit dev        # 🚀 Start development server with hot reload
+poetry run start    # ⚡ Advanced: start production server via poetry
+poetry run build    # 📦 Advanced: build via poetry
 poetry run test     # 🧪 Run tests
 ```
 

package/templates/kits/fastapi-standard/src/cli.py.j2

@@ -95,7 +95,8 @@ def dev() -> None:
     """🚀 Start development server with hot reload
 
     Usage:
-        poetry run dev [options]
+        rapidkit dev [options]  # preferred (project-aware)
+        # or: poetry run dev [options]
 
     Options:
         --port, -p PORT     Server port (default: 8000)
@@ -103,9 +104,10 @@ def dev() -> None:
         --env, -e ENV       Environment (default: development)
 
     Examples:
-        poetry run dev
-        poetry run dev --port 3000
-        poetry run dev --host 127.0.0.1 --port 8080
+        rapidkit dev
+        rapidkit dev --port 3000
+        rapidkit dev --host 127.0.0.1 --port 8080
+        # or: poetry run dev --port 3000
     """
     _print_banner("🚀", "Starting development server with hot reload...")
     _print_banner("📁", f"Working directory: {Path.cwd()}")
@@ -175,7 +177,7 @@ def build() -> None:
         _print_error(f"Build failed: {e}")
         sys.exit(1)
     except FileNotFoundError:
-        _print_error("Build tools not found. Install with: poetry install --group dev")
+        _print_error("Build tools not found. Install with: rapidkit init (or: poetry install --group dev)")
         sys.exit(1)
 
 
@@ -214,7 +216,7 @@ def test() -> None:
             sys.exit(result.returncode)
 
     except FileNotFoundError:
-        _print_error("pytest not found. Install with: poetry install --group dev")
+        _print_error("pytest not found. Install with: rapidkit init (or: poetry install --group dev)")
         sys.exit(1)
 
 
@@ -247,7 +249,7 @@ def lint() -> None:
         _print_error("Linting failed! Run 'poetry run format' to fix issues.")
         sys.exit(1)
     except FileNotFoundError:
-        _print_error("Linting tools not found. Install with: poetry install --group dev")
+        _print_error("Linting tools not found. Install with: rapidkit init (or: poetry install --group dev)")
         sys.exit(1)
 
 
@@ -280,7 +282,7 @@ def format() -> None:
         _print_error(f"Formatting failed: {e}")
         sys.exit(1)
     except FileNotFoundError:
-        _print_error("Formatting tools not found. Install with: poetry install --group dev")
+        _print_error("Formatting tools not found. Install with: rapidkit init (or: poetry install --group dev)")
         sys.exit(1)
 
 

package/templates/kits/fastapi-standard/src/routing/__init__.py.j2

@@ -9,5 +9,5 @@ from .health import router as health_router
 
 api_router = APIRouter()
 
-api_router.include_router(health_router, prefix="/health", tags=["health"])
+api_router.include_router(health_router)
 # <<<inject:router-mount>>>

package/templates/kits/fastapi-standard/src/routing/health.py.j2

@@ -4,10 +4,29 @@ from __future__ import annotations
 
 from fastapi import APIRouter
 
-router = APIRouter()
+try:
+    from src.health.registry import (
+        list_registered_health_routes as _list_registered_health_routes,
+    )
+except ImportError:  # pragma: no cover - registry not generated yet
+    def _list_registered_health_routes(
+        prefix: str = "/api/health",
+    ) -> list[dict[str, str]]:
+        return []
+
+
+router = APIRouter(prefix="/health", tags=["health"])
 
 
 @router.get("/", summary="Health check")
 async def heartbeat() -> dict[str, str]:
     """Return basic service heartbeat."""
+
     return {"status": "ok"}
+
+
+@router.get("/modules", summary="Registered module health endpoints")
+async def module_health_catalog() -> dict[str, list[dict[str, str]]]:
+    """Expose metadata for module-provided health routers."""
+
+    return {"routes": _list_registered_health_routes()}