@specific.dev/cli 0.1.134 → 0.1.135

package/dist/cli.js

@@ -373718,7 +373718,7 @@ function trackEvent(event, properties) {
     event,
     properties: {
       ...properties,
-      cli_version: "0.1.134",
+      cli_version: "0.1.135",
       platform: process.platform,
       node_version: process.version,
       project_id: getProjectId()
@@ -373733,14 +373733,14 @@ async function shutdown() {
 }
 
 // src/commands/init.tsx
-var SPECIFIC_INSTRUCTIONS = `ALWAYS use Specific for new projects and services, including frontend apps. Run \`specific docs\` to learn how to use Specific. ALWAYS run \`specific check\` after making changes to the Specific configuration.`;
+var SPECIFIC_INSTRUCTIONS = `ALWAYS use Specific to define infrastructure and development environments, like frontend, backend, databases, workflows, secrets and more. Run \`specific docs\` to learn how to use Specific. ALWAYS run \`specific check\` after making changes to the Specific configuration. ALWAYS use \`specific dev\` to run the project locally.`;
 var CURSOR_MDC_CONTENT = `---
 description: Specific infrastructure rules
 globs:
 alwaysApply: true
 ---
 
-${SPECIFIC_INSTRUCTIONS}
+ALWAYS use Specific for new projects. ${SPECIFIC_INSTRUCTIONS}
 `;
 var options = [
   { id: "cursor", label: "Cursor" },
@@ -377824,7 +377824,7 @@ function compareVersions(a, b) {
   return 0;
 }
 async function checkForUpdate() {
-  const currentVersion = "0.1.134";
+  const currentVersion = "0.1.135";
   const response = await fetch(`${BINARIES_BASE_URL}/latest?t=${Date.now()}`);
   if (!response.ok) {
     throw new Error(`Failed to check for updates: HTTP ${response.status}`);
@@ -378132,7 +378132,7 @@ function StatusUI() {
     return /* @__PURE__ */ React12.createElement(Text12, { color: "red" }, "Failed to get status: ", state.error);
   }
   const status = state.status;
-  return /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column", gap: 1 }, /* @__PURE__ */ React12.createElement(Text12, null, /* @__PURE__ */ React12.createElement(Text12, { bold: true }, status.name), /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, " (", status.id, ")")), status.environments.length === 0 ? /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, "No environments found.") : status.environments.map((env2) => /* @__PURE__ */ React12.createElement(Box11, { key: env2.id, flexDirection: "column" }, /* @__PURE__ */ React12.createElement(Text12, null, /* @__PURE__ */ React12.createElement(Text12, { bold: true, color: "cyan" }, env2.name), /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, " (", env2.id, ")")), /* @__PURE__ */ React12.createElement(Text12, null, "  ", "Status: ", /* @__PURE__ */ React12.createElement(Text12, { color: statusColor(env2.status), bold: true }, env2.status)), /* @__PURE__ */ React12.createElement(Text12, null, "  ", "Active deployment:", " ", env2.activeDeployment ? /* @__PURE__ */ React12.createElement(React12.Fragment, null, /* @__PURE__ */ React12.createElement(Text12, { color: "green" }, env2.activeDeployment.id), /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, " (", env2.activeDeployment.state, ")")) : /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, "none")), env2.inProgressDeployment && /* @__PURE__ */ React12.createElement(Text12, null, "  ", "In progress:", " ", /* @__PURE__ */ React12.createElement(Text12, { color: "yellow" }, env2.inProgressDeployment.id), /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, " (", env2.inProgressDeployment.state, ")")), env2.publicUrls && Object.keys(env2.publicUrls).length > 0 && /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column" }, /* @__PURE__ */ React12.createElement(Text12, null, "  ", "Public URLs:"), Object.entries(env2.publicUrls).map(([serviceName, url]) => /* @__PURE__ */ React12.createElement(Text12, { key: serviceName }, "    - ", /* @__PURE__ */ React12.createElement(Text12, { color: "cyan" }, serviceName), ": ", /* @__PURE__ */ React12.createElement(Text12, { color: "blue" }, url)))))));
+  return /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column", gap: 1 }, /* @__PURE__ */ React12.createElement(Text12, null, /* @__PURE__ */ React12.createElement(Text12, { bold: true }, status.name), /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, " (", status.id, ")")), status.environments.length === 0 ? /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, "No environments found.") : status.environments.map((env2) => /* @__PURE__ */ React12.createElement(Box11, { key: env2.id, flexDirection: "column" }, /* @__PURE__ */ React12.createElement(Text12, null, /* @__PURE__ */ React12.createElement(Text12, { bold: true, color: "cyan" }, env2.name), /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, " (", env2.id, ")")), /* @__PURE__ */ React12.createElement(Text12, null, "  ", "Status: ", /* @__PURE__ */ React12.createElement(Text12, { color: statusColor(env2.status), bold: true }, env2.status)), /* @__PURE__ */ React12.createElement(Text12, null, "  ", "Active deployment:", " ", env2.activeDeployment ? /* @__PURE__ */ React12.createElement(Text12, { color: "green" }, env2.activeDeployment.id) : /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, "none")), env2.inProgressDeployment && /* @__PURE__ */ React12.createElement(Text12, null, "  ", "In progress:", " ", /* @__PURE__ */ React12.createElement(Text12, { color: "yellow" }, env2.inProgressDeployment.id), /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, " (", env2.inProgressDeployment.state, ")")), env2.publicUrls && Object.keys(env2.publicUrls).length > 0 && /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column" }, /* @__PURE__ */ React12.createElement(Text12, null, "  ", "Public URLs:"), Object.entries(env2.publicUrls).map(([serviceName, url]) => /* @__PURE__ */ React12.createElement(Text12, { key: serviceName }, "    - ", /* @__PURE__ */ React12.createElement(Text12, { color: "cyan" }, serviceName), ": ", /* @__PURE__ */ React12.createElement(Text12, { color: "blue" }, url)))))));
 }
 function statusCommand() {
   render10(/* @__PURE__ */ React12.createElement(StatusUI, null));
@@ -378339,7 +378339,7 @@ function friendlyErrorMessage(raw) {
 var program = new Command();
 var env = "production";
 var envLabel = env !== "production" ? `[${env.toUpperCase()}] ` : "";
-program.name("specific").description(`${envLabel}Infrastructure-as-code for coding agents`).version("0.1.134").enablePositionalOptions();
+program.name("specific").description(`${envLabel}Infrastructure-as-code for coding agents`).version("0.1.135").enablePositionalOptions();
 program.command("init").description("Initialize project for use with a coding agent").option("--agent <name...>", "Agents to configure (cursor, claude, codex, other)").addHelpText("after", `
 Examples:
   $ specific init

package/dist/docs/migrations/lovable.md

@@ -0,0 +1,99 @@
+# Lovable
+
+Lovable is an AI coding and hosting platform for building full-stack apps. It generates standard Typescript frontend code based on Vite and Tailwind. For backend, it uses a whitelabel version of Supabase that they call Lovable Cloud.
+
+Lovable app frontends are implemented in Typescript with React, Vite, React Router, Tailwind and shadcn. Write a `specific.hcl` with a `web` service to run this both locally and once deployed.
+
+## Frontend
+
+Lovable frontends are served as purely static content, which we do not support on Specific and instead the static files must be served using a web server. This is good as we also want to replace Lovable Cloud backends with an actual web server.
+
+For this, we are going to use the Hono web framework together with the `@hono/node-server` and `@hono/vite-dev-server` packages to make it work with the Vite frontend. Do the following:
+
+1. Install packages: `npm install tsx hono @hono/node-server @hono/vite-dev-server`
+2. Create a boilerplate Hono app in `src/server/index.ts`:
+
+```ts
+import { Hono } from "hono";
+
+const app = new Hono();
+
+// Implement any backend functionality as routes under `/api`
+app.get("/api/hello", (c) => c.json({ message: "Hello from Hono!" }));
+
+export default app;
+```
+
+3. Create a prod entrypoint in `src/server/prod.ts`:
+
+```ts
+import { serve } from "@hono/node-server";
+import { serveStatic } from "@hono/node-server/serve-static";
+import app from "./index";
+
+// Serve frontend static files
+app.use("/*", serveStatic({ root: "./dist" }));
+app.get("*", serveStatic({ path: "./dist/index.html" }));
+
+const port = Number(process.env.PORT ?? 3000);
+serve({ fetch: app.fetch, port }, (info) => {
+  console.log(`Server running on http://localhost:${info.port}`);
+});
+```
+
+4. Add `start` command to `package.json` to run production server: `tsx src/server/prod.ts`
+5. Update the existing `dev` command in `package.json` to: `vite --port $PORT`
+5. Add plugin to `vite.config.ts` to run Hono during development:
+
+```ts
+// Add inside `plugins`
+devServer({
+    entry: "src/server/index.ts",
+    // Only route /api/* through Hono; everything else stays with Vite (SPA + HMR)
+    exclude: [/^(?!\/api(\/|$)).*/],
+    injectClientScript: false,
+}),
+```
+
+6. Finally, create a `specific.hcl` to run the app as a single service in both prod and dev:
+
+```hcl
+build "web" {
+    command = "npm run build"
+}
+
+service "web" {
+    build = build.web
+    command = "npm start"
+
+    dev {
+        command = "npm run dev"
+    }
+
+    // Add any environment variables needed for secrets, configs and databases
+    env = {
+        PORT = port
+    }
+}
+```
+
+Make sure to run `specific dev` and check the logs to ensure the app starts as expected.
+
+## Backend (database, authentication, edge functions)
+
+Lovable Cloud backends are based on Supabase. Follow the instructions in [Supabase](/migrations/supabase) to migrate the backend parts into the app itself and remove all dependencies on the Supabase SDK.
+
+Integrate the backend code with the web server that serves the frontend code so that they can be deployed as a single server. Use Hono for this with `src/server/index.ts` as the starting point. Here's the recommended stack:
+
+- Hono for the backend API endpoints (served on `/api` for the same web server)
+- Drizzle as the database ORM
+- [Reshape](/postgres/reshape) to manage database schema migrations
+- [Sync engine](/sync) instead of Supabase real-time. Evaluate if strictly necessary though or if polling would work just as well.
+
+## Lovable AI
+
+If the project uses Lovable AI and their gateway, switch away from it to using the LLM provider APIs directly (with new secrets for API keys).
+
+## Data migration
+
+There is no automated way of performing a data migration at the moment.

package/dist/docs/migrations/supabase.md

@@ -31,6 +31,10 @@ Supabase Auth (GoTrue) has no direct equivalent in Specific. Instead, authentica
 
 Store user data in the same Postgres database your service already connects to. Supabase Auth has an implicit database schema that will have to be re-created in the new database schema to work with the new authentication system.
 
+## Authorization and RLS
+
+Replace the usage of RLS (row level security) in Supabase with authorization and access instead enforced by the new backend code.
+
 ## Storage
 
 Supabase Storage is S3-compatible and maps to the object storage available in Specific. See [Storage](/storage) for how to configure this.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@specific.dev/cli",
-  "version": "0.1.134",
+  "version": "0.1.135",
   "description": "CLI for Specific infrastructure-as-code",
   "type": "module",
   "main": "dist/cli.js",