@crossdelta/platform-sdk 0.2.24 → 0.2.26

package/README.md

@@ -5,14 +5,17 @@
 
 > 🚀 CLI toolkit for scaffolding and managing microservice platforms
 
+Build event-driven microservice platforms with minimal boilerplate. This CLI scaffolds [Turborepo](https://turbo.build) workspaces with [Pulumi](https://pulumi.com) infrastructure, generates microservices (Hono or NestJS), and provides a unified dev experience across all services.
+
 ## Features
 
 - ⚡ **Quick Scaffolding** - Generate projects with best practices baked in
-- 🏗️ **Workspace Generator** - Scaffold complete infrastructure setups
-- 🐝 **Hono Microservices** - Lightweight, fast microservice templates
-- 🦅 **NestJS Microservices** - Enterprise-grade microservice templates
-- 🔌 **Integrations** - Add common tools like Biome, NATS, Supabase
+- 🥟 **Bun-first** - Optimized for Bun runtime with npm/yarn/pnpm fallback
+- 🏗️ **Turborepo Workspaces** - Monorepo setup with parallel builds and caching
+- 🔧 **Microservice Templates** - Hono (lightweight) & NestJS (enterprise-grade)
 - 📦 **[Pulumi](https://www.pulumi.com) Ready** - Infrastructure-as-Code out of the box
+- 🔌 **Auto Port Assignment** - Unique ports per service, no manual configuration
+- 🌍 **Env Generation** - `.env.local` auto-generated from `infra/services/*.ts` configs
 
 ## Installation
 
@@ -27,13 +30,17 @@ bun add -g @crossdelta/platform-sdk
 
 ```bash
 # Create a new workspace with infrastructure
-pf new workspace my-platform
+npx @crossdelta/platform-sdk new workspace my-platform
+cd my-platform
 
 # Create a Hono microservice
 pf new hono-micro services/orders
 
 # Create a NestJS microservice
 pf new nest-micro services/api-gateway
+
+# Start development
+pf dev
 ```
 
 ## Commands
@@ -47,12 +54,12 @@ pf dev              # Start with watch mode (default)
 pf dev --no-watch   # Start without watching for changes
 ```
 
-**Features:**
-- Generates `.env.local` from `infra/services/*.ts` configurations
-- Starts all services via `turbo start:dev`
-- Watches `infra/services/` for file changes → restarts all services
-- Watches `services/` and `apps/` for new/deleted packages → restarts all services
-
+**What it does:**
+1. Generates `.env.local` from service configurations in `infra/services/*.ts`
+2. Starts all services in parallel via `turbo start:dev`
+3. Watches for changes:
+   - `infra/services/` → Regenerates env and restarts on config changes
+   - `services/` & `apps/` → Detects new/deleted packages and reinstalls dependencies
 
 **Configuration via `package.json`:**
 ```json
@@ -110,7 +117,6 @@ pf new nest-micro services/api-gateway
 - Biome linting
 - Docker support
 - Health checks
-- NATS integration (optional)
 
 ## Options
 
@@ -120,24 +126,6 @@ pf new nest-micro services/api-gateway
 | `-P, --package-manager <pm>` | Specify package manager (npm, yarn, pnpm, bun) |
 | `-h, --help` | Show help |
 
-## Integrations
-
-When creating microservices, you can optionally add integrations:
-
-- **Biome** - Fast linter and formatter
-- **NATS** - Message broker integration
-- **Supabase** - Database and auth
-- **CloudEvents** - Event-driven architecture
-
-## Programmatic Usage
-
-```typescript
-import { createWorkspaceCommand } from '@crossdelta/platform-sdk'
-
-// Use in your own CLI
-myProgram.addCommand(createWorkspaceCommand)
-```
-
 ## Requirements
 
 - Node.js >= 21.0.0