create-projx 1.4.0 → 1.4.1

package/README.md

@@ -131,6 +131,8 @@ npx create-projx pin <patterns...>
 npx create-projx unpin <patterns...>
 npx create-projx pin --list
 npx create-projx doctor [--fix]
+npx create-projx gen entity <name>
+npx create-projx sync [--url <url>]
 
 --components <list>    Comma-separated: fastapi,fastify,frontend,mobile,e2e,infra
 --no-git               Skip git init
@@ -174,6 +176,46 @@ npx create-projx doctor --fix   # auto-fix what's possible
 
 Checks: config validity, component markers, baseline ref, stale worktrees, skip pattern coverage.
 
+### Generate Entities
+
+Scaffold a new entity across all components in your project:
+
+```bash
+npx create-projx gen entity invoice                                          # interactive
+npx create-projx gen entity invoice --fields "name:string,amount:number"     # non-interactive
+```
+
+Generates based on what's in your `.projx`:
+
+| Component | Generated |
+| --------- | --------- |
+| `fastapi` | `src/entities/<name>/_model.py` — auto-discovered by registry |
+| `fastify` | `src/modules/<name>/schemas.ts` + `index.ts` + Prisma model + app.ts import |
+| `frontend` | `src/types/<name>.ts` — TypeScript interface + Create/Update variants |
+| `mobile` | `lib/entities/<name>/model.dart` — Dart class with fromJson/toJson/copyWith |
+
+No migrations — run `alembic revision --autogenerate` or `npx prisma migrate dev` when ready.
+
+### Sync Types
+
+Regenerate all frontend/mobile types from a running backend:
+
+```bash
+npx create-projx sync                                              # auto-detects URL
+npx create-projx sync --url http://localhost:8000/api/v1/_meta      # explicit URL
+```
+
+Fetches `/_meta` from your backend, generates typed interfaces for every entity. Run after any backend change — new field, renamed column, new entity.
+
+The generic `api.ts` client accepts type parameters:
+
+```tsx
+import type { Invoice } from '../types/invoice';
+
+const { data } = await api.list<Invoice>('/invoices');    // data: Invoice[]
+const item = await api.get<Invoice>('/invoices', id);     // item: Invoice
+```
+
 ## Rename Component Directories
 
 Rename `fastapi/` to `backend/`? Just rename the folder — the `.projx-component` marker file moves with it. The `update` command auto-discovers where each component lives by scanning for these markers. No config changes needed.

package/dist/index.js

@@ -261,12 +261,29 @@ function render(template, vars) {
     const ifMatch = line.match(/^<%\s*if\s*\((.+?)\)\s*\{?\s*%>$/);
     if (ifMatch) {
       const fn = new Function("components", "projectName", `return ${ifMatch[1]}`);
-      stack.push(fn(components, projectName));
+      const result = fn(components, projectName);
+      stack.push({ active: result, matched: result });
+      continue;
+    }
+    const elseIfMatch = line.match(/^<%\s*\}\s*else\s+if\s*\((.+?)\)\s*\{?\s*%>$/);
+    if (elseIfMatch) {
+      if (stack.length > 0) {
+        const top = stack[stack.length - 1];
+        if (top.matched) {
+          top.active = false;
+        } else {
+          const fn = new Function("components", "projectName", `return ${elseIfMatch[1]}`);
+          const result = fn(components, projectName);
+          top.active = result;
+          if (result) top.matched = true;
+        }
+      }
       continue;
     }
     if (/^<%\s*\}\s*else\s*\{?\s*%>$/.test(line)) {
       if (stack.length > 0) {
-        stack[stack.length - 1] = !stack[stack.length - 1];
+        const top = stack[stack.length - 1];
+        top.active = !top.matched;
       }
       continue;
     }
@@ -274,7 +291,7 @@ function render(template, vars) {
       stack.pop();
       continue;
     }
-    if (stack.length > 0 && stack.some((v) => !v)) continue;
+    if (stack.length > 0 && stack.some((v) => !v.active)) continue;
     const replaced = line.replace(
       /<%=\s*([\w.]+)\s*%>/g,
       (_, expr) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-projx",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "Scaffold production-grade fullstack projects in seconds. FastAPI, Fastify, React, Flutter, Terraform — with auth, database, CI/CD, E2E tests, and Docker. One command, ready to deploy.",
   "type": "module",
   "bin": {

package/src/templates/docker-compose.dev.yml.ejs

@@ -24,7 +24,7 @@ services:
       - app-network
 <% } %>
 <% if (components.includes('fastapi')) { %>
-  migrate:
+  <%= paths.fastapi %>-migrate:
     build: ./<%= paths.fastapi %>
     command: ['uv', 'run', 'migrate.py']
     environment:
@@ -39,8 +39,7 @@ services:
           cpus: '0.5'
     networks:
       - app-network
-
-  backend:
+  <%= paths.fastapi %>:
     build: ./<%= paths.fastapi %>
     command:
       [
@@ -61,7 +60,7 @@ services:
       - ./<%= paths.fastapi %>/alembic.ini:/app/alembic.ini
       - ./<%= paths.fastapi %>/migrate.py:/app/migrate.py
     depends_on:
-      migrate:
+      <%= paths.fastapi %>-migrate:
         condition: service_completed_successfully
     restart: unless-stopped
     healthcheck:
@@ -83,7 +82,22 @@ services:
       - app-network
 <% } %>
 <% if (components.includes('fastify')) { %>
-  backend-fastify:
+  <%= paths.fastify %>-migrate:
+    build: ./<%= paths.fastify %>
+    command: ['pnpm', 'prisma', 'migrate', 'deploy']
+    environment:
+      - DATABASE_URL=postgresql://dev:dev@db:5432/app
+    depends_on:
+      db:
+        condition: service_healthy
+    deploy:
+      resources:
+        limits:
+          memory: 256M
+          cpus: '0.5'
+    networks:
+      - app-network
+  <%= paths.fastify %>:
     build: ./<%= paths.fastify %>
     command: ['pnpm', 'dev']
     ports:
@@ -96,8 +110,8 @@ services:
     volumes:
       - ./<%= paths.fastify %>/src:/app/src
     depends_on:
-      db:
-        condition: service_healthy
+      <%= paths.fastify %>-migrate:
+        condition: service_completed_successfully
     restart: unless-stopped
     healthcheck:
       test: ['CMD', 'wget', '--spider', '-q', 'http://localhost:3000/api/health']
@@ -121,23 +135,21 @@ services:
     ports:
       - '5173:5173'
     environment:
-<% if (components.includes('fastapi')) { %>
-      - VITE_API_URL=http://localhost:7860
-<% } %>
-<% if (components.includes('fastify') && !components.includes('fastapi')) { %>
+<% if (components.includes('fastify')) { %>
       - VITE_API_URL=http://localhost:3000
+<% } else if (components.includes('fastapi')) { %>
+      - VITE_API_URL=http://localhost:7860
 <% } %>
     volumes:
       - ./<%= paths.frontend %>:/app
       - frontend_node_modules:/app/node_modules
-<% if (components.includes('fastapi')) { %>
+<% if (components.includes('fastify')) { %>
     depends_on:
-      backend:
+      <%= paths.fastify %>:
         condition: service_healthy
-<% } %>
-<% if (components.includes('fastify') && !components.includes('fastapi')) { %>
+<% } else if (components.includes('fastapi')) { %>
     depends_on:
-      backend-fastify:
+      <%= paths.fastapi %>:
         condition: service_healthy
 <% } %>
     healthcheck:
@@ -154,7 +166,6 @@ services:
     networks:
       - app-network
 <% } %>
-
 volumes:
 <% if (components.includes('fastapi') || components.includes('fastify')) { %>
   pgdata:
@@ -162,7 +173,6 @@ volumes:
 <% if (components.includes('frontend')) { %>
   frontend_node_modules:
 <% } %>
-
 networks:
   app-network:
     driver: bridge

package/src/templates/docker-compose.yml.ejs

@@ -1,14 +1,13 @@
 services:
 <% if (components.includes('fastapi')) { %>
-  migrate:
+  <%= paths.fastapi %>-migrate:
     build: ./<%= paths.fastapi %>
     command: ["uv", "run", "migrate.py"]
     env_file:
       - ./<%= paths.fastapi %>/.env
     networks:
       - app-network
-
-  backend:
+  <%= paths.fastapi %>:
     build: ./<%= paths.fastapi %>
     expose:
       - "7860"
@@ -16,7 +15,7 @@ services:
       - ./<%= paths.fastapi %>/.env
     restart: unless-stopped
     depends_on:
-      migrate:
+      <%= paths.fastapi %>-migrate:
         condition: service_completed_successfully
     healthcheck:
       test:
@@ -34,13 +33,23 @@ services:
       - app-network
 <% } %>
 <% if (components.includes('fastify')) { %>
-  backend-fastify:
+  <%= paths.fastify %>-migrate:
+    build: ./<%= paths.fastify %>
+    command: ["pnpm", "prisma", "migrate", "deploy"]
+    env_file:
+      - ./<%= paths.fastify %>/.env
+    networks:
+      - app-network
+  <%= paths.fastify %>:
     build: ./<%= paths.fastify %>
     expose:
       - "3000"
     env_file:
       - ./<%= paths.fastify %>/.env
     restart: unless-stopped
+    depends_on:
+      <%= paths.fastify %>-migrate:
+        condition: service_completed_successfully
     healthcheck:
       test: ["CMD", "wget", "--spider", "-q", "http://localhost:3000/api/health"]
       interval: 30s
@@ -62,14 +71,13 @@ services:
     volumes:
       - letsencrypt:/etc/letsencrypt
       - certbot-www:/var/www/certbot
-<% if (components.includes('fastapi')) { %>
+<% if (components.includes('fastify')) { %>
     depends_on:
-      backend:
+      <%= paths.fastify %>:
         condition: service_healthy
-<% } %>
-<% if (components.includes('fastify') && !components.includes('fastapi')) { %>
+<% } else if (components.includes('fastapi')) { %>
     depends_on:
-      backend-fastify:
+      <%= paths.fastapi %>:
         condition: service_healthy
 <% } %>
     restart: unless-stopped
@@ -81,7 +89,6 @@ services:
       start_period: 10s
     networks:
       - app-network
-
   certbot:
     image: certbot/certbot:latest
     volumes:
@@ -102,7 +109,6 @@ volumes:
   letsencrypt:
   certbot-www:
 <% } %>
-
 networks:
   app-network:
     driver: bridge