@fluid-app/fluid-cli-portal 0.1.13 → 0.1.15

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fluid-app/fluid-cli-portal",
-  "version": "0.1.13",
-  "description": "Fluid CLI plugin for building and deploying portal applications",
+  "version": "0.1.15",
+  "description": "Fluid CLI plugin for building portal applications",
   "files": [
     "dist",
     "templates"
@@ -25,7 +25,6 @@
   "dependencies": {
     "chalk": "^5.3.0",
     "commander": "^12.0.0",
-    "dotenv": "^17.3.1",
     "execa": "^8.0.0",
     "fs-extra": "^11.2.0",
     "handlebars": "^4.7.8",
@@ -33,7 +32,7 @@
     "p-limit": "^7.3.0",
     "prompts": "^2.4.2",
     "tsx": "^4.21.0",
-    "@fluid-app/fluid-cli": "0.1.3"
+    "@fluid-app/fluid-cli": "0.1.4"
   },
   "devDependencies": {
     "@swc/core": "^1.15.18",
@@ -45,8 +44,8 @@
     "tsdown": "^0.21.0",
     "typescript": "^5",
     "vite": "^6.0.0",
-    "@fluid-app/fluidos-api-client": "0.1.0",
-    "@fluid-app/typescript-config": "0.0.0"
+    "@fluid-app/typescript-config": "0.0.0",
+    "@fluid-app/fluidos-api-client": "0.1.0"
   },
   "engines": {
     "node": ">=18.0.0"

package/templates/fullstack/.dockerignore

@@ -1,9 +0,0 @@
-node_modules
-dist
-.env
-.env.*
-!.env.example
-.git
-*.db
-*.db-journal
-*.db-wal

package/templates/fullstack/.env.example

@@ -1,15 +0,0 @@
-# ─── Development ─────────────────────────────────────────────────────────────
-VITE_API_URL=https://api.fluid.app
-DATABASE_URL=file:local.db
-DATABASE_AUTH_TOKEN=
-
-# Allowed CORS origin (defaults to http://localhost:5173 in development)
-ALLOWED_ORIGIN=
-
-# ─── Deployment (used by `fluid deploy`) ─────────────────────────────────────
-# Fluid company API key (required for deploy/destroy)
-FLUID_COMPANY_API_KEY=
-
-# Get your API token at: https://app.turso.tech/api-tokens
-TURSO_API_TOKEN=
-TURSO_ORG=

package/templates/fullstack/.github/workflows/ci.yml

@@ -1,47 +0,0 @@
-name: CI
-on:
-  pull_request:
-    branches: [main]
-
-jobs:
-  typecheck:
-    name: Typecheck
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          cache: pnpm
-      - run: pnpm install --frozen-lockfile
-      - run: pnpm typecheck
-
-  lint:
-    name: Lint
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          cache: pnpm
-      - run: pnpm install --frozen-lockfile
-      - run: pnpm lint
-
-  test:
-    name: Test
-    runs-on: ubuntu-latest
-    env:
-      DATABASE_URL: file:test.db
-    steps:
-      - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          cache: pnpm
-      - run: pnpm install --frozen-lockfile
-      - run: pnpm db:push
-      - run: pnpm test

package/templates/fullstack/.github/workflows/deploy.yml

@@ -1,54 +0,0 @@
-name: Deploy
-on:
-  push:
-    branches: [main]
-  workflow_dispatch:
-
-jobs:
-  build:
-    name: Build & Validate
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Enable corepack
-        run: corepack enable
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          cache: pnpm
-
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
-      - name: Build
-        run: pnpm build
-
-  deploy:
-    name: Deploy to Cloud Run
-    needs: [build]
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Authenticate to Google Cloud
-        uses: google-github-actions/auth@v2
-        with:
-          credentials_json: ${{ secrets.GCP_SA_JSON }}
-
-      - name: Set up Cloud SDK
-        uses: google-github-actions/setup-gcloud@v2
-
-      - name: Get service name
-        id: meta
-        run: echo "service=$(jq -r .name package.json | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9-]/-/g' | sed 's/^-\|-$//g')" >> "$GITHUB_OUTPUT"
-
-      - name: Deploy to Cloud Run
-        run: |
-          gcloud run deploy ${{ steps.meta.outputs.service }} \
-            --source . \
-            --region ${{ vars.CLOUD_RUN_REGION || 'us-central1' }} \
-            --project ${{ vars.GCP_PROJECT }} \
-            --allow-unauthenticated \
-            --set-env-vars="DATABASE_URL=${{ secrets.DATABASE_URL }},DATABASE_AUTH_TOKEN=${{ secrets.DATABASE_AUTH_TOKEN }},NODE_ENV=production"

package/templates/fullstack/Dockerfile

@@ -1,44 +0,0 @@
-FROM node:20-slim AS builder
-
-WORKDIR /app
-
-# Copy package files
-COPY package.json pnpm-lock.yaml ./
-
-# Install dependencies
-RUN corepack enable && pnpm install --frozen-lockfile
-
-# Copy source code
-COPY . .
-
-# Build frontend (Vite) and server (esbuild)
-RUN pnpm run build
-
-# Collect production files into a staging directory for clean cross-stage copy
-RUN mkdir /staging && cp package.json pnpm-lock.yaml /staging/
-
-# --- Production stage ---
-FROM node:20-slim AS runner
-
-WORKDIR /app
-
-ENV NODE_ENV=production
-ENV PORT=8080
-
-# Copy build outputs and migration files
-COPY --from=builder /app/dist ./dist
-COPY --from=builder /app/drizzle ./drizzle
-
-# Copy package + lock files for production install
-COPY --from=builder /staging ./
-
-# Install production dependencies only (@libsql/client needs node_modules)
-RUN corepack enable && pnpm install --prod --frozen-lockfile
-
-RUN addgroup --system --gid 1001 appgroup && \
-    adduser --system --uid 1001 --ingroup appgroup appuser
-USER appuser
-
-EXPOSE 8080
-
-CMD ["node", "dist/server/entry.js"]

package/templates/fullstack/README.md.template

@@ -1,176 +0,0 @@
-# {{projectName}}
-
-A Fluid Commerce Portal built with the **Fullstack** template — includes [Hono](https://hono.dev/) API server, [Drizzle ORM](https://orm.drizzle.team/), and SQLite for a complete frontend + backend setup.
-
-## What's Included
-
-### Frontend
-
-- [React 19](https://react.dev/) with [TypeScript](https://www.typescriptlang.org/)
-- [Vite](https://vite.dev/) for fast development and optimized builds
-- [Tailwind CSS 4](https://tailwindcss.com/) for utility-first styling
-- [TanStack Query](https://tanstack.com/query) for data fetching and caching
-- [Fluid Portal SDK](https://github.com/fluidcommerce) for Fluid Commerce integration
-- Pre-configured navigation, screen routing, and dashboard widgets
-
-### Backend
-
-- [Hono](https://hono.dev/) — lightweight, fast API server integrated with Vite dev server
-- [Drizzle ORM](https://orm.drizzle.team/) — type-safe SQL with zero overhead
-- [libSQL](https://github.com/tursodatabase/libsql-client-ts) — SQLite-compatible database, works locally and with [Turso](https://turso.tech/)
-- Example CRUD routes (`/api/todos`) to get started quickly
-
-## Getting Started
-
-```bash
-# Install dependencies
-pnpm install
-
-# Push the database schema (creates the SQLite database)
-pnpm db:push
-
-# Start the development server
-pnpm dev
-```
-
-Open [http://localhost:5173](http://localhost:5173) to view your portal. _(Port may differ if 5173 is in use — check the dev server output.)_
-
-### Other Commands
-
-```bash
-pnpm build       # Build for production (frontend + server)
-pnpm start       # Start the production server
-pnpm preview     # Preview production build via Vite
-pnpm typecheck   # Run TypeScript type checking
-pnpm lint        # Run ESLint
-```
-
-## Database Setup
-
-This template uses SQLite with Drizzle ORM. The database is stored as a local file (`local.db`).
-
-```bash
-# Create or update the database schema from your Drizzle schema definitions
-pnpm db:push
-
-# Open Drizzle Studio to browse and edit your data
-pnpm db:studio
-
-# Generate SQL migration files (for production workflows)
-pnpm db:generate
-
-# Run pending migrations
-pnpm db:migrate
-```
-
-Edit the schema in `src/server/db/schema.ts`, then run `pnpm db:push` to apply changes during development.
-
-## Project Structure
-
-```
-src/
-├── main.tsx              # App entry with FluidProvider setup
-├── App.tsx               # Main app with screen routing
-├── index.css             # Global styles (Tailwind CSS)
-├── fluid.config.ts       # Fluid SDK configuration
-├── portal.config.ts      # Navigation and screen registration
-├── navigation/
-│   └── index.tsx         # Sidebar navigation component
-├── screens/
-│   └── Dashboard.tsx     # Dashboard with widgets
-└── server/
-    ├── index.ts          # Hono app (mounts routes, exported for dev + prod)
-    ├── entry.ts          # Production server entry (Node.js + static serving)
-    ├── routes/
-    │   └── index.ts      # Example CRUD routes (/api/todos)
-    └── db/
-        ├── index.ts      # Database connection
-        ├── migrate.ts    # Auto-migration on server start
-        └── schema.ts     # Drizzle schema definitions
-```
-
-## Adding API Routes
-
-Create a new route file in `src/server/routes/` and mount it in `src/server/index.ts`:
-
-```typescript
-// src/server/routes/products.ts
-import { Hono } from "hono";
-
-export const productRoutes = new Hono();
-
-productRoutes.get("/", async (c) => {
-  // your logic here
-  return c.json({ products: [] });
-});
-```
-
-```typescript
-// src/server/index.ts
-import { productRoutes } from "./routes/products";
-
-app.route("/api/products", productRoutes);
-```
-
-## Using Turso (Cloud Database)
-
-This template uses `@libsql/client`, which works with both local SQLite files and [Turso](https://turso.tech/) cloud databases. To use Turso:
-
-1. Create a Turso database: `turso db create my-app`
-2. Get the connection URL: `turso db show my-app --url`
-3. Create an auth token: `turso db tokens create my-app`
-4. Set `DATABASE_URL` and `DATABASE_AUTH_TOKEN` in your `.env` file
-
-## Docker
-
-Build and run with Docker:
-
-```bash
-docker build -t {{projectName}} .
-docker run -p 8080:8080 -e DATABASE_URL=<your-turso-url> -e DATABASE_AUTH_TOKEN=<your-token> {{projectName}}
-```
-
-Database migrations run automatically when the server starts, so the database schema is always up to date.
-
-## CI/CD
-
-This project includes GitHub Actions workflows for automated checks and deployment.
-
-### Pull Request Checks
-
-Every pull request runs typecheck and lint automatically. See `.github/workflows/ci.yml`.
-
-### Deployment
-
-Pushes to `main` automatically deploy to Cloud Run. To set this up:
-
-1. **Run initial deploy locally** (provisions Turso database + first Cloud Run deploy):
-   ```bash
-   fluid deploy
-   ```
-
-2. **Note the database credentials** from the deploy output (DATABASE_URL and DATABASE_AUTH_TOKEN)
-
-3. **Add GitHub repository secrets** (Settings > Secrets and variables > Actions):
-   - `GCP_SA_JSON` — GCP service account key JSON ([create one](https://cloud.google.com/iam/docs/creating-managing-service-account-keys))
-   - `DATABASE_URL` — Turso database URL from step 1
-   - `DATABASE_AUTH_TOKEN` — Turso auth token from step 1
-
-4. **Add GitHub repository variables** (Settings > Secrets and variables > Actions > Variables):
-   - `GCP_PROJECT` — Your GCP project ID
-   - `CLOUD_RUN_REGION` — Cloud Run region (default: `us-central1`)
-
-5. **Push to main** — deployment happens automatically
-
-## Styling
-
-This project uses [Tailwind CSS 4](https://tailwindcss.com/) for styling. The global styles are imported in `src/index.css`. You can customize the theme and add utilities there.
-
-## Learn More
-
-- [Fluid Portal SDK Documentation](https://github.com/fluidcommerce)
-- [Hono Documentation](https://hono.dev/)
-- [Drizzle ORM Documentation](https://orm.drizzle.team/)
-- [Vite Documentation](https://vite.dev/)
-- [React Documentation](https://react.dev/)
-- [Tailwind CSS Documentation](https://tailwindcss.com/)

package/templates/fullstack/drizzle/0000_initial.sql

@@ -1,7 +0,0 @@
-CREATE TABLE IF NOT EXISTS `todos` (
-	`id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
-	`title` text NOT NULL,
-	`completed` integer DEFAULT false NOT NULL,
-	`created_at` text DEFAULT (current_timestamp) NOT NULL,
-	`updated_at` text DEFAULT (current_timestamp) NOT NULL
-);

package/templates/fullstack/drizzle/meta/0000_snapshot.json

@@ -1,63 +0,0 @@
-{
-  "id": "00000000-0000-0000-0000-000000000000",
-  "prevId": "",
-  "version": "6",
-  "dialect": "sqlite",
-  "tables": {
-    "todos": {
-      "name": "todos",
-      "columns": {
-        "id": {
-          "name": "id",
-          "type": "integer",
-          "primaryKey": true,
-          "notNull": true,
-          "autoincrement": true
-        },
-        "title": {
-          "name": "title",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false
-        },
-        "completed": {
-          "name": "completed",
-          "type": "integer",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false,
-          "default": false
-        },
-        "created_at": {
-          "name": "created_at",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false,
-          "default": "(current_timestamp)"
-        },
-        "updated_at": {
-          "name": "updated_at",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false,
-          "default": "(current_timestamp)"
-        }
-      },
-      "indexes": {},
-      "foreignKeys": {},
-      "compositePrimaryKeys": {},
-      "uniqueConstraints": {},
-      "checkConstraints": {}
-    }
-  },
-  "enums": {},
-  "views": {},
-  "_meta": {
-    "schemas": {},
-    "tables": {},
-    "columns": {}
-  }
-}

package/templates/fullstack/drizzle/meta/_journal.json

@@ -1,13 +0,0 @@
-{
-  "version": "7",
-  "dialect": "sqlite",
-  "entries": [
-    {
-      "idx": 0,
-      "version": "7",
-      "when": 1737000000000,
-      "tag": "0000_initial",
-      "breakpoints": true
-    }
-  ]
-}

package/templates/fullstack/drizzle.config.ts

@@ -1,13 +0,0 @@
-import { defineConfig } from "drizzle-kit";
-
-const url = process.env.DATABASE_URL ?? "file:local.db";
-const isLocal = url.startsWith("file:") || url === ":memory:";
-
-export default defineConfig({
-  schema: "./src/server/db/schema.ts",
-  out: "./drizzle",
-  dialect: isLocal ? "sqlite" : "turso",
-  dbCredentials: isLocal
-    ? { url }
-    : { url, authToken: process.env.DATABASE_AUTH_TOKEN },
-});

package/templates/fullstack/esbuild.config.js

@@ -1,14 +0,0 @@
-import { build } from "esbuild";
-
-await build({
-  entryPoints: ["src/server/entry.ts"],
-  bundle: true,
-  platform: "node",
-  target: "node20",
-  format: "esm",
-  outfile: "dist/server/entry.js",
-  external: ["@libsql/client", "drizzle-orm"],
-  banner: {
-    js: 'import { createRequire } from "module"; const require = createRequire(import.meta.url);',
-  },
-});

package/templates/fullstack/package.json.template

@@ -1,58 +0,0 @@
-{
-  "name": "{{projectName}}",
-  "version": "0.1.0",
-  "private": true,
-  "type": "module",
-  "scripts": {
-    "dev": "vite",
-    "build": "vite build && node esbuild.config.js",
-    "start": "node dist/server/entry.js",
-    "preview": "vite preview",
-    "typecheck": "tsc --noEmit",
-    "lint": "oxlint",
-    "db:generate": "drizzle-kit generate",
-    "db:migrate": "drizzle-kit migrate",
-    "db:push": "drizzle-kit push",
-    "db:studio": "drizzle-kit studio",
-    "deploy": "fluid deploy",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
-  "dependencies": {
-    "@fluid-app/portal-preview": "{{sdkVersion}}",
-    "@fluid-app/portal-sdk": "{{sdkVersion}}",
-    "@tanstack/react-query": "^5.90.0",
-    "@hono/node-server": "^1.13.0",
-    "@libsql/client": "^0.17.0",
-    "drizzle-orm": "^0.44.0",
-    "hono": "^4.7.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "react-hook-form": "^7.55.0",
-    "@hookform/resolvers": "^4.1.3",
-    "zod": "^3.24.0"
-  },
-  "devDependencies": {
-    "@fluid-app/fluid-cli-portal": "{{sdkVersion}}",
-    "@hono/vite-dev-server": "^0.25.0",
-    "@tailwindcss/vite": "^4.0.0",
-    "esbuild": "^0.25.0",
-    "@types/node": "^22.0.0",
-    "@types/react": "^19.0.0",
-    "@types/react-dom": "^19.0.0",
-    "@vitejs/plugin-react": "^4.3.0",
-    "drizzle-kit": "^0.31.0",
-    "oxlint": "^1.51.0",
-    "tailwindcss": "^4.0.0",
-    "typescript": "^5.6.0",
-    "vite": "^6.0.0",
-    "vitest": "^4.0.0"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "packageManager": "pnpm@10.4.1",
-  "pnpm": {
-    "onlyBuiltDependencies": ["esbuild"]
-  }
-}

package/templates/fullstack/src/server/db/index.ts

@@ -1,10 +0,0 @@
-import { createClient } from "@libsql/client";
-import { drizzle } from "drizzle-orm/libsql";
-import * as schema from "./schema";
-
-const client = createClient({
-  url: process.env.DATABASE_URL ?? "file:local.db",
-  authToken: process.env.DATABASE_AUTH_TOKEN,
-});
-
-export const db = drizzle(client, { schema });

package/templates/fullstack/src/server/db/migrate.ts

@@ -1,12 +0,0 @@
-import { dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { migrate } from "drizzle-orm/libsql/migrator";
-import { db } from "./index";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-export async function runMigrations() {
-  await migrate(db, {
-    migrationsFolder: resolve(__dirname, "../../../drizzle"),
-  });
-}

package/templates/fullstack/src/server/db/schema.ts

@@ -1,14 +0,0 @@
-import { sqliteTable, integer, text } from "drizzle-orm/sqlite-core";
-import { sql } from "drizzle-orm";
-
-export const todos = sqliteTable("todos", {
-  id: integer("id").primaryKey({ autoIncrement: true }),
-  title: text("title").notNull(),
-  completed: integer("completed", { mode: "boolean" }).notNull().default(false),
-  createdAt: text("created_at")
-    .notNull()
-    .default(sql`(current_timestamp)`),
-  updatedAt: text("updated_at")
-    .notNull()
-    .default(sql`(current_timestamp)`),
-});

package/templates/fullstack/src/server/entry.ts

@@ -1,59 +0,0 @@
-import { serve } from "@hono/node-server";
-import { serveStatic } from "@hono/node-server/serve-static";
-import { runMigrations } from "./db/migrate";
-import app from "./index";
-
-// Run database migrations before starting the server
-try {
-  await runMigrations();
-} catch (error) {
-  console.error("Failed to run database migrations:", error);
-  console.error(
-    "Ensure DATABASE_URL and DATABASE_AUTH_TOKEN are set correctly.",
-  );
-  process.exit(1);
-}
-
-// Cache immutable hashed assets for 1 year
-app.use("/assets/*", async (c, next) => {
-  await next();
-  c.header("Cache-Control", "public, max-age=31536000, immutable");
-});
-
-// Serve static frontend assets from dist/public/
-app.use("/*", serveStatic({ root: "./dist/public" }));
-
-// SPA fallback — serve index.html for all unmatched routes
-app.get("*", serveStatic({ root: "./dist/public", path: "index.html" }));
-
-const port = Number(process.env.PORT) || 8080;
-
-const server = serve({ fetch: app.fetch, port }, (info) => {
-  console.log(`Server listening on http://localhost:${info.port}`);
-});
-
-server.on("error", (err: NodeJS.ErrnoException) => {
-  if (err.code === "EADDRINUSE") {
-    console.error(`\nPort ${port} is already in use.`);
-    console.error(
-      `Try: PORT=${port === 8080 ? 3001 : port + 1} node dist/server/entry.js\n`,
-    );
-    process.exit(1);
-  }
-  throw err;
-});
-
-// Graceful shutdown
-function shutdown() {
-  console.log("Shutting down gracefully...");
-  server.close();
-  const forceExit = setTimeout(() => {
-    console.error("Forcing shutdown after timeout");
-    process.exit(1);
-  }, 10_000);
-  // Allow the process to exit naturally if close finishes before timeout
-  forceExit.unref();
-}
-
-process.on("SIGTERM", shutdown);
-process.on("SIGINT", shutdown);