rapidkit 0.14.0 → 0.14.2

package/README.md

@@ -5,11 +5,13 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
 [![GitHub Stars](https://img.shields.io/github/stars/getrapidkit/rapidkit-npm.svg?style=flat-square)](https://github.com/getrapidkit/rapidkit-npm/stargazers)
 
-> ⚠️ **PRE-RELEASE VERSION** - This is a companion tool for RapidKit framework.  
-> The stable production version of RapidKit Python will be released soon on PyPI.
+> ⚠️ **PREVIEW VERSION** - This package provides demo templates for testing RapidKit's workflow.  
+> Full module ecosystem and advanced features will be available after the Python Core release.
 
 🚀 The easiest way to create FastAPI and NestJS projects with RapidKit templates!
 
+> 🔮 **Coming Soon:** AI-powered module recommendations when Core modules are released!
+
 **💡 Tip:** Use the [RapidKit VS Code Extension](https://marketplace.visualstudio.com/items?itemName=rapidkit.rapidkit-vscode) for a visual interface!
 
 ## Quick Start
@@ -60,10 +62,12 @@ npx rapidkit admin-api --template nestjs      # Create NestJS project
 
 ## Templates
 
-| Template | Framework | Description |
-|----------|-----------|-------------|
-| `fastapi` | FastAPI | Python async web framework with automatic API docs |
-| `nestjs` | NestJS | TypeScript Node.js framework with modular architecture |
+| Template  | Framework | Description                                            |
+| --------- | --------- | ------------------------------------------------------ |
+| `fastapi` | FastAPI   | Python async web framework with automatic API docs     |
+| `nestjs`  | NestJS    | TypeScript Node.js framework with modular architecture |
+
+> 📦 **Note:** These templates are designed for testing the RapidKit workflow. Full module ecosystem coming with Core release!
 
 ## CLI Options
 
@@ -72,11 +76,13 @@ npx rapidkit [project-name] [options]
 ```
 
 ### Arguments
+
 - `project-name` - Name of project/workspace directory to create
 
 ### Options
+
 - `-t, --template <template>` - Template to use: `fastapi` or `nestjs` (creates direct project)
-- `--skip-git` - Skip git initialization  
+- `--skip-git` - Skip git initialization
 - `--skip-install` - Skip installing dependencies (for NestJS)
 - `--debug` - Enable verbose debug logging
 - `--dry-run` - Preview what would be created without creating it
@@ -158,9 +164,34 @@ my-api/
 
 ## Requirements
 
-- **Node.js**: 18+ (for running npx)
-- **For FastAPI**: Python 3.11+ with Poetry
+- **Node.js**: 20.19.6+ (LTS recommended)
+- **For FastAPI**: Python 3.10.14+ with Poetry 2.2.1+
 - **For NestJS**: Node.js 20+ with npm/yarn/pnpm
+- **Git**: For version control
+
+> 💡 **Tip:** Use [RapidKit VS Code Extension](https://marketplace.visualstudio.com/items?itemName=rapidkit.rapidkit-vscode) - includes system checker to verify all requirements!
+
+## What's Next?
+
+This npm package is currently in **preview mode** with demo templates. Here's what's coming:
+
+### 🚀 After Core Release (v1.0.0)
+
+- **Full Module Ecosystem** - 50+ production-ready modules
+- **AI-Powered Recommendations** - Intelligent module suggestions
+- **Seamless Integration** - npm package becomes thin wrapper over Python Core
+- **Dynamic Modules** - Install any module from the registry
+- **Advanced Features** - All RapidKit power through npm
+
+### 📦 Current Focus (v0.15.0)
+
+- Polish existing features
+- Improve documentation
+- Optimize bundle size
+- Prepare Core integration bridge
+- Enhanced error messages
+
+**Stay tuned!** Follow our progress on [GitHub](https://github.com/getrapidkit/rapidkit-npm).
 
 ## Development
 

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rapidkit",
-  "version": "0.13.1",
+  "version": "0.14.2",
   "type": "module",
   "description": "Create RapidKit projects with a single command - The official CLI for RapidKit framework",
   "keywords": [
@@ -77,7 +77,7 @@
     "vitest": "^4.0.15"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.19.6"
   },
   "lint-staged": {
     "*.ts": [

package/package.json

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

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

@@ -56,6 +56,24 @@ def _python_code_targets(root: Path) -> list[str]:
     return targets or ["src"]
 
 
+def _get_poetry_venv() -> Path | None:
+    """Get Poetry virtualenv path if it exists"""
+    try:
+        result = subprocess.run(
+            ["poetry", "env", "info", "--path"],
+            capture_output=True,
+            text=True,
+            check=False
+        )
+        if result.returncode == 0 and result.stdout.strip():
+            venv_path = Path(result.stdout.strip())
+            if venv_path.exists():
+                return venv_path
+    except Exception:
+        pass
+    return None
+
+
 def _venv_has_uvicorn(venv_path: Path) -> bool:
     if (venv_path / "bin" / "uvicorn").exists():
         return True
@@ -77,9 +95,16 @@ def dev(port: int = 8000, host: str = "0.0.0.0", allow_global_runtime: bool = Fa
         _print_banner("📁", f"Working directory: {root}")
         _print_banner("🌐", f"Server will be available at: http://{host}:{port}")
 
+        # Check for .venv or Poetry virtualenv
+        if not venv_dir.exists():
+            poetry_venv = _get_poetry_venv()
+            if poetry_venv:
+                venv_dir = poetry_venv
+                _print_banner("🐍", f"Using Poetry virtualenv: {venv_dir}")
+
         if venv_dir.exists():
             if not _venv_has_uvicorn(venv_dir):
-                print("❌ Project .venv was found but uvicorn/fastapi doesn't appear installed.")
+                print("❌ Project virtualenv was found but uvicorn/fastapi doesn't appear installed.")
                 print("💡 Run 'rapidkit init' to install dependencies.")
                 sys.exit(1)
         else:
@@ -141,9 +166,16 @@ def start(port: int = 8000, host: str = "0.0.0.0", allow_global_runtime: bool =
     
     if ptype == "python":
         venv_dir = root / ".venv"
+        
+        # Check for .venv or Poetry virtualenv
+        if not venv_dir.exists():
+            poetry_venv = _get_poetry_venv()
+            if poetry_venv:
+                venv_dir = poetry_venv
+
         if venv_dir.exists():
             if not _venv_has_uvicorn(venv_dir):
-                print("❌ Project .venv was found but uvicorn/fastapi doesn't appear installed.")
+                print("❌ Project virtualenv was found but uvicorn/fastapi doesn't appear installed.")
                 print("💡 Run 'poetry install' to install dependencies.")
                 sys.exit(1)
         else:

package/templates/kits/fastapi-standard/.rapidkit/rapidkit.j2

@@ -48,6 +48,15 @@ fi
 VENV_PY="${ROOT_DIR}/.venv/bin/python"
 VENV_POETRY="${ROOT_DIR}/.venv/bin/poetry"
 
+# Try to detect Poetry virtualenv path
+if [ ! -d "${ROOT_DIR}/.venv" ] && command -v poetry >/dev/null 2>&1; then
+  POETRY_VENV_PATH=$(cd "$ROOT_DIR" && poetry env info --path 2>/dev/null || true)
+  if [ -n "$POETRY_VENV_PATH" ] && [ -d "$POETRY_VENV_PATH" ]; then
+    VENV_PY="${POETRY_VENV_PATH}/bin/python"
+    VENV_POETRY="${POETRY_VENV_PATH}/bin/poetry"
+  fi
+fi
+
 case "$PKG_TYPE" in
   python)
     # prefer project-local poetry