@specific.dev/cli 0.1.39 → 0.1.41

package/dist/admin/index.txt

@@ -11,7 +11,7 @@ f:I[68027,[],"default"]
 :HL["/_next/static/chunks/5ff94899b8b7a03a.css","style"]
 :HL["/_next/static/media/797e433ab948586e-s.p.dbea232f.woff2","font",{"crossOrigin":"","type":"font/woff2"}]
 :HL["/_next/static/media/caa3a2e1cccd8315-s.p.853070df.woff2","font",{"crossOrigin":"","type":"font/woff2"}]
-0:{"P":null,"b":"cNL40bpv360RCjyOls7vD","c":["",""],"q":"","i":false,"f":[[["",{"children":["__PAGE__",{}]},"$undefined","$undefined",true],[["$","$1","c",{"children":[[["$","link","0",{"rel":"stylesheet","href":"/_next/static/chunks/5ff94899b8b7a03a.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}]],["$","html",null,{"lang":"en","children":["$","body",null,{"className":"geist_a71539c9-module__T19VSG__variable geist_mono_8d43a2aa-module__8Li5zG__variable antialiased","children":["$","$L2",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L3",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":[[["$","title",null,{"children":"404: This page could not be found."}],["$","div",null,{"style":{"fontFamily":"system-ui,\"Segoe UI\",Roboto,Helvetica,Arial,sans-serif,\"Apple Color Emoji\",\"Segoe UI Emoji\"","height":"100vh","textAlign":"center","display":"flex","flexDirection":"column","alignItems":"center","justifyContent":"center"},"children":["$","div",null,{"children":[["$","style",null,{"dangerouslySetInnerHTML":{"__html":"body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}"}}],["$","h1",null,{"className":"next-error-h1","style":{"display":"inline-block","margin":"0 20px 0 0","padding":"0 23px 0 0","fontSize":24,"fontWeight":500,"verticalAlign":"top","lineHeight":"49px"},"children":404}],["$","div",null,{"style":{"display":"inline-block"},"children":["$","h2",null,{"style":{"fontSize":14,"fontWeight":400,"lineHeight":"49px","margin":0},"children":"This page could not be found."}]}]]}]}]],[]],"forbidden":"$undefined","unauthorized":"$undefined"}]}]}]]}],{"children":[["$","$1","c",{"children":[["$","$L4",null,{"Component":"$5","serverProvidedParams":{"searchParams":{},"params":{},"promises":["$@6","$@7"]}}],[["$","script","script-0",{"src":"/_next/static/chunks/ff1a16fafef87110.js","async":true,"nonce":"$undefined"}],["$","script","script-1",{"src":"/_next/static/chunks/6aae09c9429b9f24.js","async":true,"nonce":"$undefined"}],["$","script","script-2",{"src":"/_next/static/chunks/0476153b08658d87.js","async":true,"nonce":"$undefined"}]],["$","$L8",null,{"children":["$","$9",null,{"name":"Next.MetadataOutlet","children":"$@a"}]}]]}],{},null,false,false]},null,false,false],["$","$1","h",{"children":[null,["$","$Lb",null,{"children":"$Lc"}],["$","div",null,{"hidden":true,"children":["$","$Ld",null,{"children":["$","$9",null,{"name":"Next.Metadata","children":"$Le"}]}]}],["$","meta",null,{"name":"next-size-adjust","content":""}]]}],false]],"m":"$undefined","G":["$f",[]],"S":true}
+0:{"P":null,"b":"9wAYbYI1Gg_jzlXqEZ1W5","c":["",""],"q":"","i":false,"f":[[["",{"children":["__PAGE__",{}]},"$undefined","$undefined",true],[["$","$1","c",{"children":[[["$","link","0",{"rel":"stylesheet","href":"/_next/static/chunks/5ff94899b8b7a03a.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}]],["$","html",null,{"lang":"en","children":["$","body",null,{"className":"geist_a71539c9-module__T19VSG__variable geist_mono_8d43a2aa-module__8Li5zG__variable antialiased","children":["$","$L2",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L3",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":[[["$","title",null,{"children":"404: This page could not be found."}],["$","div",null,{"style":{"fontFamily":"system-ui,\"Segoe UI\",Roboto,Helvetica,Arial,sans-serif,\"Apple Color Emoji\",\"Segoe UI Emoji\"","height":"100vh","textAlign":"center","display":"flex","flexDirection":"column","alignItems":"center","justifyContent":"center"},"children":["$","div",null,{"children":[["$","style",null,{"dangerouslySetInnerHTML":{"__html":"body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}"}}],["$","h1",null,{"className":"next-error-h1","style":{"display":"inline-block","margin":"0 20px 0 0","padding":"0 23px 0 0","fontSize":24,"fontWeight":500,"verticalAlign":"top","lineHeight":"49px"},"children":404}],["$","div",null,{"style":{"display":"inline-block"},"children":["$","h2",null,{"style":{"fontSize":14,"fontWeight":400,"lineHeight":"49px","margin":0},"children":"This page could not be found."}]}]]}]}]],[]],"forbidden":"$undefined","unauthorized":"$undefined"}]}]}]]}],{"children":[["$","$1","c",{"children":[["$","$L4",null,{"Component":"$5","serverProvidedParams":{"searchParams":{},"params":{},"promises":["$@6","$@7"]}}],[["$","script","script-0",{"src":"/_next/static/chunks/ff1a16fafef87110.js","async":true,"nonce":"$undefined"}],["$","script","script-1",{"src":"/_next/static/chunks/6aae09c9429b9f24.js","async":true,"nonce":"$undefined"}],["$","script","script-2",{"src":"/_next/static/chunks/0476153b08658d87.js","async":true,"nonce":"$undefined"}]],["$","$L8",null,{"children":["$","$9",null,{"name":"Next.MetadataOutlet","children":"$@a"}]}]]}],{},null,false,false]},null,false,false],["$","$1","h",{"children":[null,["$","$Lb",null,{"children":"$Lc"}],["$","div",null,{"hidden":true,"children":["$","$Ld",null,{"children":["$","$9",null,{"name":"Next.Metadata","children":"$Le"}]}]}],["$","meta",null,{"name":"next-size-adjust","content":""}]]}],false]],"m":"$undefined","G":["$f",[]],"S":true}
 6:{}
 7:"$0:f:0:1:1:children:0:props:children:0:props:serverProvidedParams:params"
 c:[["$","meta","0",{"charSet":"utf-8"}],["$","meta","1",{"name":"viewport","content":"width=device-width, initial-scale=1"}]]

package/dist/cli.js

@@ -182491,7 +182491,7 @@ function trackEvent(event, properties) {
     event,
     properties: {
       ...properties,
-      cli_version: "0.1.39",
+      cli_version: "0.1.41",
       platform: process.platform,
       node_version: process.version,
       project_id: getProjectId()
@@ -190217,53 +190217,42 @@ function DeployUI({ environment, config, skipBuildTest }) {
   useEffect5(() => {
     if (state.phase !== "testing-builds" || !state.projectId) return;
     let cancelled = false;
-    async function runBuildTests() {
+    let pollInterval;
+    async function runBuildTestsAndDeploy() {
       const projectDir = process.cwd();
       const builds = config.builds || [];
-      if (skipBuildTest || builds.length === 0) {
-        writeLog("deploy", skipBuildTest ? "Skipping build tests (--skip-build-test)" : "No builds to test");
-        setState((s) => ({ ...s, phase: "creating-tarball" }));
-        return;
-      }
-      writeLog("deploy", `Testing ${builds.length} build(s) locally`);
-      try {
-        const results = await testAllBuilds(builds, projectDir);
-        if (cancelled) return;
-        if (!results.allPassed) {
-          const failures = results.results.filter((r) => !r.success);
-          const errorMsg = failures.map((f) => `Build "${f.buildName}" failed:
+      if (!skipBuildTest && builds.length > 0) {
+        writeLog("deploy", `Testing ${builds.length} build(s) locally`);
+        try {
+          const results = await testAllBuilds(builds, projectDir);
+          if (cancelled) return;
+          if (!results.allPassed) {
+            const failures = results.results.filter((r) => !r.success);
+            const errorMsg = failures.map((f) => `Build "${f.buildName}" failed:
 ${f.output}`).join("\n\n");
+            writeLog("deploy:error", errorMsg);
+            setState({
+              phase: "error",
+              error: `Build test failed:
+${errorMsg}`
+            });
+            return;
+          }
+          writeLog("deploy", "All builds passed local testing");
+        } catch (err) {
+          if (cancelled) return;
+          const errorMsg = `Build test failed: ${err instanceof Error ? err.message : String(err)}`;
           writeLog("deploy:error", errorMsg);
           setState({
             phase: "error",
-            error: `Build test failed:
-${errorMsg}`
+            error: errorMsg
           });
           return;
         }
-        writeLog("deploy", "All builds passed local testing");
-        setState((s) => ({ ...s, phase: "creating-tarball" }));
-      } catch (err) {
-        if (cancelled) return;
-        const errorMsg = `Build test failed: ${err instanceof Error ? err.message : String(err)}`;
-        writeLog("deploy:error", errorMsg);
-        setState({
-          phase: "error",
-          error: errorMsg
-        });
+      } else {
+        writeLog("deploy", skipBuildTest ? "Skipping build tests (--skip-build-test)" : "No builds to test");
       }
-    }
-    runBuildTests();
-    return () => {
-      cancelled = true;
-    };
-  }, [state.phase, state.projectId, config.builds, skipBuildTest]);
-  useEffect5(() => {
-    if (state.phase !== "creating-tarball" || !state.projectId) return;
-    let cancelled = false;
-    let pollInterval;
-    async function deploy() {
-      const projectDir = process.cwd();
+      setState((s) => ({ ...s, phase: "creating-tarball" }));
       writeLog("deploy", `Starting deployment to "${environment}"`);
       writeLog("deploy", `Project directory: ${projectDir}`);
       const authToken = await getValidAccessToken();
@@ -190404,12 +190393,12 @@ ${errorMsg}`
       pollInterval = setInterval(pollForCompletion, 2e3);
       pollForCompletion();
     }
-    deploy();
+    runBuildTestsAndDeploy();
     return () => {
       cancelled = true;
       if (pollInterval) clearInterval(pollInterval);
     };
-  }, [state.projectId, environment]);
+  }, [state.projectId, environment, config.builds, skipBuildTest]);
   useEffect5(() => {
     let pollInterval;
     if ((state.phase === "building" || state.phase === "deploying") && state.deployment && state.missingSecrets === void 0 && state.secretValues === void 0 && state.missingConfigs === void 0 && state.configValues === void 0) {
@@ -191291,7 +191280,7 @@ function logoutCommand() {
 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.39").enablePositionalOptions();
+program.name("specific").description(`${envLabel}Infrastructure-as-code for coding agents`).version("0.1.41").enablePositionalOptions();
 program.command("init").description("Initialize project for use with a coding agent").action(initCommand);
 program.command("docs [topic]").description("Fetch LLM-optimized documentation").action(docsCommand);
 program.command("check").description("Validate specific.hcl configuration").action(checkCommand);

package/dist/docs/index.md

@@ -28,3 +28,15 @@ The following is a list of common frameworks and libraries with guidance on how
 - [Next.js](/integrations/nextjs): full-stack React framework
 - [Drizzle ORM](/integrations/drizzle): TypeScript ORM with type safety
 - [Prisma](/integrations/prisma): TypeScript ORM with auto-generated client
+
+## Adding Specific to existing projects / migrating to Specific
+
+When adding Specific to an existing codebase, explore the codebase in detail to figure out what infrastructure components is needed. In particular:
+
+- Find ALL secrets and config variables, make sure they are read from environment variables and define them in `specific.hcl`. If a `.env` file exists, guide the user to move that into local Specific configuration instead.
+
+### Common migrations
+
+If the codebase uses any of the following technologies, read the migration guides linked:
+
+- [Supabase](/migrations/supabase)

package/dist/docs/migrations/supabase.md

@@ -0,0 +1,58 @@
+# Supabase
+
+Supabase is a backend-as-a-service and framework built around Postgres. It automatically generates a backend API based on the Postgres schema which can be connected to from the frontend. To migrate to Specific, a backend service must be built to replicate the API that Supabase generates automatically, and also implement any edge functions.
+
+Pick a backend stack together with the user (programming language/framework) to be used to replace Supabase.
+
+## Database
+
+Both Supabase and Specific use Postgres, so the schema transfers directly. Determine the schema from the Supabase codebase or export the existing schema from Supabase:
+
+```
+supabase db dump --schema public > schema.sql
+```
+
+Configure a [Postgres](/postgres) database through Specific connected to the backend and set up the schema and database migrations in the stack chosen for the project.
+
+## API / Backend Service / Edge Functions
+
+Supabase auto-generates a PostgREST API from your database schema. With Specific, you write an explicit backend service that handles routing, request validation, and business logic. This gives you full control over your API surface and means we need to re-implement the routes that Supabase provides derived from the database.
+
+Read the frontend code to determine what endpoints are needed and implement them on the backend. Keep in mind that Supabase uses RLS for authorization, which doesn't translate well without Supabase Authentication present. Instead, read the RLS policies and mirror the logic into the new backend service instead.
+
+Supabase supports writing custom code for the backend using what they call Edge Functions. Transfer these over to be part of the new backend service instead and deployed with the rest of the API.
+
+## Authentication
+
+Supabase Auth (GoTrue) has no direct equivalent in Specific. Instead, authentication should be integrated in whatever way suits the stack chosen for the project, for example:
+
+- Authentication library. For Typescript/Javascript stacks, we recommend [BetterAuth](https://www.better-auth.com/llms.txt)
+- External auth provider (Auth0, Clerk, WorkOS, etc.)
+
+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.
+
+## Storage
+
+Supabase Storage is S3-compatible and maps to the object storage available in Specific. See [Storage](/storage) for how to configure this.
+
+## Realtime
+
+Supabase Realtime can be replace with the sync engine available in Specific. See [sync](/sync) for configuration and implementation details.
+
+## Queues
+
+There is currently no equivalent to Supabase Queues available in Specific. It will be coming soon. Tell the user to reach out to fabian@specific.dev if you have a need for this.
+
+## Cron
+
+There is currently no equivalent to Supabase Cron available in Specific. It will be coming soon. Tell the user to reach out to fabian@specific.dev if you have a need for this.
+
+## Client-side Changes
+
+- Remove the `@supabase/supabase-js` dependency
+- Replace all Supabase client calls with standard `fetch` requests to your backend API service
+- Pass auth tokens via request headers (e.g., `Authorization: Bearer <token>`) to the backend service for authenticated endpoints
+
+## Data migration
+
+Data migration out of Supabase Postgres and Storage (S3) into Specific is currently a manual process. Help guide the user through this if they want it.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@specific.dev/cli",
-  "version": "0.1.39",
+  "version": "0.1.41",
   "description": "CLI for Specific infrastructure-as-code",
   "type": "module",
   "main": "dist/cli.js",
@@ -52,4 +52,4 @@
     "@types/react": "^19.2.7",
     "esbuild": "^0.24.0"
   }
-}
+}