@ramme-io/create-app 2.0.1 → 2.0.2

package/README.md

@@ -1,67 +1,84 @@
-# Create Ramme App
+# @ramme-io/create-app
 
 [![NPM Version](https://img.shields.io/npm/v/@ramme-io/create-app.svg)](https://www.npmjs.com/package/@ramme-io/create-app) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-The easiest way to start a new **Ramme** project — designed for creators, not just developers.
+**The official CLI tool to bootstrap a Ramme application.**
 
-This CLI scaffolds a production-ready React application with:
-- **@ramme-io/ui:** Pre-built, accessible components that just work.
-- **Tailwind CSS:** Fully configured for the Ramme design system.
-- **Vite:** Lightning-fast development with instant hot-reload.
-- **TypeScript:** Your safety net — catch mistakes before they ship.
+One command. Zero configuration. A production-grade project in seconds.
 
-## 🚀 Quick Start
+---
+
+## Quick Start
 
-Get started in seconds. No global installation required.
+No global installation required. Run directly with `npx`:
 
 ```bash
-npm create @ramme-io/app my-app
-# or
-npm create @ramme-io/app my-app
+npx @ramme-io/create-app@latest my-project
 ```
 
-You will be prompted to name your project.
+Or using the `npm create` shorthand:
 
-**1. Enter the project directory**
 ```bash
-cd my-new-project
+npm create @ramme-io/app@latest my-project
 ```
 
-**2. Install dependencies**
-```bash
-pnpm install
-# or npm install
-```
+Then start developing:
 
-**3. Start the dev server**
 ```bash
+cd my-project
+pnpm install
 pnpm run dev
 ```
 
-Your prototype is now running locally at `http://localhost:5173`.
+Your app is running at `http://localhost:5173`.
 
 ---
 
-## The Tech Stack
+## What's Included
 
-This starter kit is an opinionated selection of the best open-source tools available:
+The CLI generates a fully configured project with:
 
-* **Vite:** Next-generation tooling for instant server start and lightning-fast HMR (Hot Module Replacement).
-* **React:** The standard library for building composable user interfaces.
-* **TypeScript:** Statically typed JavaScript for scalable, robust application logic.
-* **Tailwind CSS:** A utility-first styling engine configured with Ramme design tokens.
-* **@ramme-io/ui:** A pre-installed suite of accessible, unstyled primitives based on Radix UI.
+- **Vite** — Instant dev server start and sub-second HMR.
+- **React 19** — The standard library for composable user interfaces.
+- **TypeScript** — Static typing for scalable, robust application logic.
+- **Tailwind CSS** — Utility-first styling pre-configured with Ramme design tokens.
+- **@ramme-io/ui** — The full Ramme component library, pre-installed and ready to import.
+- **@ramme-io/kernel** — The core routing and rendering engine, pre-wired to the manifest system.
+
+### Generated Project Structure
+
+```
+my-project/
+├── src/
+│   ├── config/
+│   │   ├── app.manifest.ts    # App title, description, theme settings
+│   │   └── sitemap.ts         # Page definitions and navigation structure
+│   ├── core/
+│   │   └── component-registry.tsx  # Maps component names to React components
+│   ├── pages/                 # Your page components
+│   └── data/                  # Mock data and seed files
+├── tailwind.config.js         # Pre-loaded with @ramme-io/ui preset
+├── vite.config.ts
+└── package.json
+```
 
 ---
 
-## Project Links
+## Related Packages
 
-* **`@ramme-io/ui`**: The core library of visual primitives.
-* **`@ramme-io/create-app`** (This Repository): The quick start kit.
+- **[@ramme-io/ui](https://www.npmjs.com/package/@ramme-io/ui)** — The component library.
+- **[@ramme-io/kernel](https://www.npmjs.com/package/@ramme-io/kernel)** — The core routing and rendering engine.
+
+---
+
+## Documentation
+
+For full documentation, visit [https://ramme.io/docs](https://ramme.io/docs).
 
 ---
 
 ## License
 
-Copyright © 2026 Ramme Framework.
-This project is licensed under the [MIT License](LICENSE).
+MIT License — Copyright © 2026 Ramme Framework.
+
+See [LICENSE](LICENSE) for details.

package/index.js

@@ -43,20 +43,22 @@ try {
     fs.renameSync(fallbackPkgPath, targetPkgPath);
   }
 
-  // 3. HARDEN SUPPLY CHAIN (Force Injection)
+  // 3. HARDEN SUPPLY CHAIN — Strip workspace:* for public installs
   if (fs.existsSync(targetPkgPath)) {
     const pkg = fs.readJsonSync(targetPkgPath);
-    
-    // Direct Overwrite
-    pkg.dependencies["@ramme-io/kernel"] = RELEASE_VERSION;
-    pkg.dependencies["@ramme-io/ui"] = RELEASE_VERSION;
-    
-    // Cleanup
-    delete pkg.devDependencies["@ramme-io/kernel"];
-    delete pkg.devDependencies["@ramme-io/ui"];
+    const WORKSPACE_TARGETS = ['@ramme-io/kernel', '@ramme-io/ui', '@ramme-io/shared'];
+
+    for (const dep of WORKSPACE_TARGETS) {
+      for (const section of ['dependencies', 'devDependencies']) {
+        if (pkg[section]?.[dep] && pkg[section][dep].includes('workspace:')) {
+          pkg[section][dep] = RELEASE_VERSION;
+          console.log(`   🔧 ${section} → ${dep}: workspace:* → ${RELEASE_VERSION}`);
+        }
+      }
+    }
 
     fs.writeJsonSync(targetPkgPath, pkg, { spaces: 2 });
-    console.log(`✅ Hardened Supply Chain: Pinned to ${RELEASE_VERSION}`);
+    console.log('✅ Supply chain hardened. Workspace dependencies stripped.');
   }
 
   // 4. Handle Gitignore

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ramme-io/create-app",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "description": "The official CLI to create Ramme applications.",
   "type": "module",
   "private": false,
@@ -20,4 +20,4 @@
   "dependencies": {
     "fs-extra": "^11.2.0"
   }
-}
+}