create-seamless 0.1.0 → 0.1.2

package/README.md

@@ -3,85 +3,142 @@
 [![License: AGPL-3.0-only](https://img.shields.io/badge/License-AGPL3-yellow.svg)](LICENSE)
 [![npm version](https://img.shields.io/npm/v/create-seamless.svg?style=flat)](https://www.npmjs.com/package/create-seamless)
 
-`create-seamless` is a project scaffolding tool for building applications with **Seamless Auth**, an open source, passwordless authentication system.
+`create-seamless` is a CLI for bootstrapping applications with Seamless Auth, an open source, passwordless authentication system.
 
-It provisions a local, production-shaped development environment that can include:
+It guides you through creating a fully working authentication stack with a web app, API, and auth server that are already connected and ready to run.
 
-- The Seamless Auth open source server
-- A starter web application
-- A starter API server
+---
+
+## Getting started
+
+Run the CLI with `npx`:
+
+```bash
+npx create-seamless my-app
+```
+
+Or run it in your current directory:
+
+```bash
+npx create-seamless
+```
 
-The generated project is fully local and requires no hosted services or external accounts to run.
+You’ll be guided through a short setup process where you can choose:
+
+- Whether to create a web application
+- Whether to create an API server
+- How to run the auth server (local or Docker)
+- Whether to run everything with Docker
 
 ---
 
-## What this creates
+## What gets created
 
-Depending on the flags provided, `create-seamless` scaffolds a local project with the following structure:
+Depending on your selections, the CLI generates a project like this:
 
 ```text
 my-app/
-├─ auth/        # Seamless Auth OSS server
-├─ web/         # Starter web application (optional)
-├─ api/         # Starter API server (optional)
+├─ auth/        # Seamless Auth server (optional)
+├─ web/         # React web application (optional)
+├─ api/         # Express API server (optional)
+├─ docker-compose.yml (optional)
 └─ README.md
 ```
 
-Each service is independently runnable and preconfigured to work together using local URLs and environment variables.
+All services are preconfigured to work together.
 
-The intended development workflow is to run each service in its own terminal:
+- Web calls the API
+- API communicates with the auth server
+- Auth manages sessions and tokens
 
-```bash
-# terminal 1
-cd auth && npm run dev
+No manual wiring is required.
+
+---
+
+## Running your project
 
-# terminal 2
-cd api && npm run dev
+### Option 1: Docker
 
-# terminal 3
-cd web && npm run dev
+If you choose Docker during setup:
+
+```bash
+docker compose up
 ```
 
+This starts:
+
+- PostgreSQL
+- Auth server
+- API server
+- Web app
+
+All services are configured to communicate correctly inside the container network.
+
 ---
 
-## Usage
+### Option 2: Local development
+
+If you choose to run locally:
+
+#### 1. Start PostgreSQL
+
+Make sure you have a local PostgreSQL instance running on port `5432`.
+
+---
 
-Run via `npx`:
+#### 2. Start the auth server
 
 ```bash
-npx create-seamless my-app
+cd auth
+npm install
+
+npm run db:create
+npm run db:migrate
+
+npm run dev
 ```
 
-By default, this scaffolds the full local stack:
+---
 
-- Seamless Auth server
-- Web application
-- API server
+#### 3. Start the API
+
+```bash
+cd api
+npm install
+npm run dev
+```
+
+---
+
+#### 4. Start the web app
+
+```bash
+cd web
+npm install
+npm run dev
+```
 
 ---
 
-## CLI options
+## What is configured for you
+
+create-seamless handles the parts that are usually difficult to get right:
 
-| Flag          | Description                                  |
-| ------------- | -------------------------------------------- |
-| `--auth`      | Include the Seamless Auth open source server |
-| `--web`       | Include the starter web application          |
-| `--api`       | Include the starter API server               |
-| `--install`   | Automatically install dependencies           |
-| `--no-git`    | Skip git initialization                      |
-| `--auth-port` | Auth server port (default: 3000)             |
-| `--api-port`  | API server port (default: 4000)              |
-| `--web-port`  | Web dev server port (default: 5173)          |
+- Shared API service tokens
+- JWT signing configuration
+- JWKS key generation for production mode
+- Cross-service environment variables
+- CORS and cookie-based session handling
 
-If no component flags are provided, all components are included.
+Everything is aligned across services so the system works immediately after setup.
 
 ---
 
 ## Included projects
 
-`create-seamless` pulls directly from the following open source repositories:
+create-seamless pulls from the following repositories:
 
-- Seamless Auth Server
+- Seamless Auth API
   [https://github.com/fells-code/seamless-auth-api](https://github.com/fells-code/seamless-auth-api)
 
 - Seamless Auth React Starter
@@ -90,29 +147,29 @@ If no component flags are provided, all components are included.
 - Seamless Auth API Starter
   [https://github.com/fells-code/seamless-auth-starter-express](https://github.com/fells-code/seamless-auth-starter-express)
 
-Each repository can be used independently, but `create-seamless` wires them together for local development out of the box.
+Each project can be used independently, but the CLI connects them into a working system.
 
 ---
 
 ## Documentation
 
-Full documentation for Seamless Auth, including architecture, configuration, and deployment guidance, is available at:
+Full documentation is available at:
 
-[https://seamlessauth.com/docs](https://seamlessauth.com/docs)
+[https://docs.seamlessauth.com](https://docs.seamlessauth.com)
 
 ---
 
 ## Philosophy
 
-Seamless Auth is designed around:
+Seamless Auth is built around a few principles:
 
 - Passwordless authentication only
-- Embedded auth (no redirects or callbacks)
-- Self-hosted, open source foundations
+- No redirects or third-party auth providers
+- Self-hosted by default
 - Production-shaped local development
-- Minimal assumptions and explicit configuration
+- Explicit configuration over hidden behavior
 
-`create-seamless` exists to make getting started with this model straightforward and repeatable.
+create-seamless exists to make this setup fast and repeatable.
 
 ---
 
@@ -120,12 +177,13 @@ Seamless Auth is designed around:
 
 - Node.js 18 or newer
 - npm or pnpm
+- Docker (optional)
 
 ---
 
 ## License
 
-**AGPL-3.0-only** © 2026 Fells Code LLC
+AGPL-3.0-only © 2026 Fells Code LLC
 
 This license ensures:
 
@@ -133,4 +191,4 @@ This license ensures:
 - freedom to self-host and modify
 - sustainability of the managed service offering
 
-See [`LICENSE`](./LICENSE) for details.
+See `LICENSE` for details.

package/dist/commands/bootstrapAdmin.js

@@ -0,0 +1,96 @@
+import fs from "fs";
+import path from "path";
+import { intro, outro, text, confirm, spinner } from "@clack/prompts";
+import kleur from "kleur";
+import { resolveBootstrapSecret } from "../core/bootstrapSecret.js";
+function loadConfig() {
+    const configPath = path.join(process.cwd(), "seamless.config.json");
+    if (!fs.existsSync(configPath)) {
+        throw new Error("No seamless.config.json found. Run init first.");
+    }
+    return JSON.parse(fs.readFileSync(configPath, "utf-8"));
+}
+export async function runBootstrapAdmin(emailArg) {
+    intro("Seamless Auth Bootstrap");
+    const config = loadConfig();
+    let email = emailArg;
+    if (!email) {
+        email = (await text({
+            message: "Admin email address",
+            placeholder: "admin@example.com",
+            validate: (value) => {
+                if (!value || !value.includes("@")) {
+                    return "Enter a valid email address";
+                }
+            },
+        }));
+    }
+    const proceed = await confirm({
+        message: "Create bootstrap admin invite?",
+        initialValue: true,
+    });
+    if (!proceed) {
+        outro("Cancelled.");
+        return;
+    }
+    let apiUrl = process.env.SEAMLESS_API_URL;
+    if (!apiUrl) {
+        apiUrl = "http://localhost:3000";
+    }
+    let secret = resolveBootstrapSecret();
+    if (secret) {
+        console.log(kleur.gray("Using bootstrap secret from local environment"));
+    }
+    else {
+        console.log("");
+        console.log(kleur.yellow("No bootstrap secret detected automatically."));
+        console.log("This may happen if the project is not initialized locally or running in production.");
+        secret = (await text({
+            message: "Bootstrap secret",
+            placeholder: "Enter your bootstrap secret",
+            validate: (value) => {
+                if (!value)
+                    return "Bootstrap secret is required";
+            },
+        }));
+    }
+    const s = spinner();
+    s.start("Creating bootstrap invite...");
+    try {
+        const res = await fetch(`${apiUrl}/auth/internal/bootstrap/admin-invite`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${secret}`,
+            },
+            body: JSON.stringify({ email }),
+        });
+        const data = await res.json();
+        if (!res.ok) {
+            s.stop("Failed");
+            console.error(kleur.red("Error creating bootstrap invite"));
+            console.error(data);
+            process.exit(1);
+        }
+        s.stop("Done");
+        console.log("");
+        if (data?.data?.url) {
+            console.log(kleur.bold("Registration URL"));
+            console.log(kleur.cyan(data.data.url));
+        }
+        else {
+            console.log(kleur.green(`Invite sent to ${email}`));
+        }
+        console.log("");
+        console.log("Next step:");
+        console.log("The invited user must complete registration to receive admin access.");
+        outro("Bootstrap complete.");
+    }
+    catch (err) {
+        s.stop("Failed");
+        console.error(kleur.red("Unexpected error"));
+        console.error(err.message);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=bootstrapAdmin.js.map

package/dist/commands/bootstrapAdmin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrapAdmin.js","sourceRoot":"","sources":["../../src/commands/bootstrapAdmin.ts"],"names":[],"mappings":"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"}

package/dist/commands/check.js

@@ -0,0 +1,92 @@
+import fs from "fs";
+import path from "path";
+import { execSync } from "child_process";
+export async function runCheck() {
+    console.log("\nSeamless Check\n");
+    const root = process.cwd();
+    const configPath = path.join(root, "seamless.config.json");
+    if (!fs.existsSync(configPath)) {
+        console.log("✖ seamless.config.json not found");
+        console.log("→ Run: seamless init\n");
+        return;
+    }
+    console.log("✔ Config file found");
+    const config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    checkStructure(root, config);
+    checkDocker();
+    checkCompose(root, config);
+    checkContainers();
+    await checkHealth();
+    console.log("\nCheck complete.\n");
+}
+function checkStructure(root, config) {
+    const services = config.services;
+    if (fs.existsSync(path.join(root, services.web.path))) {
+        console.log("✔ Web project detected");
+    }
+    else {
+        console.log("✖ Web project missing");
+    }
+    if (fs.existsSync(path.join(root, services.api.path))) {
+        console.log("✔ API project detected");
+    }
+    else {
+        console.log("✖ API project missing");
+    }
+}
+function checkDocker() {
+    try {
+        execSync("docker --version", { stdio: "ignore" });
+        console.log("✔ Docker is installed");
+    }
+    catch {
+        console.log("✖ Docker not found");
+        console.log("→ Install Docker: https://docs.docker.com/get-docker/");
+    }
+}
+function checkCompose(root, config) {
+    const composePath = path.join(root, config.docker.composeFile);
+    if (fs.existsSync(composePath)) {
+        console.log("✔ Docker Compose file found");
+    }
+    else {
+        console.log("✖ docker-compose.yml missing");
+    }
+}
+function checkContainers() {
+    try {
+        const output = execSync("docker ps --format '{{.Names}}'").toString();
+        if (!output.includes("api")) {
+            console.log("✖ API container not running");
+            console.log("→ Run: docker compose up\n");
+        }
+        else {
+            console.log("✔ Containers running");
+        }
+    }
+    catch {
+        console.log("✖ Failed to check containers");
+    }
+}
+async function checkHealth() {
+    const checks = [
+        { name: "API", url: "http://localhost:3000/" },
+        { name: "Auth", url: "http://localhost:5312/health/status" },
+        { name: "Admin", url: "http://localhost:5174" },
+    ];
+    for (const check of checks) {
+        try {
+            const res = await fetch(check.url);
+            if (res.ok) {
+                console.log(`✔ ${check.name} is healthy`);
+            }
+            else {
+                console.log(`✖ ${check.name} returned ${res.status}`);
+            }
+        }
+        catch {
+            console.log(`✖ ${check.name} not reachable`);
+        }
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/commands/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"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"}

package/dist/commands/help.js

@@ -0,0 +1,103 @@
+import { VERSION } from "../index.js";
+export function printHelp() {
+    console.log(`
+create-seamless v${VERSION}
+
+Seamless Auth CLI — scaffold and manage full-stack authentication systems.
+
+────────────────────────────────────────────
+
+USAGE
+
+  seamless init [project-name]
+  seamless check
+  seamless bootstrap-admin [email]
+  seamless --help
+  seamless --version
+
+────────────────────────────────────────────
+
+COMMANDS
+
+  init [project-name]
+    Scaffold a new Seamless Auth project
+
+    Without a name:
+      • Creates project in current directory
+
+    With a name:
+      • Creates new directory
+
+  check
+    Validate project setup, Docker, and running services
+
+  bootstrap-admin [email]
+    Create a bootstrap admin invite
+
+    Automatically resolves bootstrap secret from:
+      • .env
+      • auth/.env
+      • docker-compose.yml
+
+    If not found, you will be prompted.
+
+    Examples:
+      seamless bootstrap-admin
+      seamless bootstrap-admin admin@example.com
+
+────────────────────────────────────────────
+
+BEHAVIOR
+
+  seamless <project-name>
+
+    • Shortcut for: seamless init <project-name>
+
+────────────────────────────────────────────
+
+GETTING STARTED
+
+  1. seamless init
+  2. docker-compose up
+  3. seamless bootstrap-admin
+
+    → Complete registration to become admin
+
+────────────────────────────────────────────
+
+WHAT YOU GET
+
+  • Web application (React starter)
+  • API server (Express)
+  • SeamlessAuth server (Docker or local)
+  • Admin dashboard (Docker or source)
+  • Docker Compose setup
+
+────────────────────────────────────────────
+
+EXAMPLES
+
+  seamless init
+    → Interactive setup in current directory
+
+  seamless init my-app
+    → Create new project in ./my-app
+
+  seamless my-app
+    → Shortcut for init
+
+  seamless check
+    → Validate your project
+
+  seamless bootstrap-admin
+    → Create your first admin user
+
+────────────────────────────────────────────
+
+DOCS
+
+  https://docs.seamlessauth.com
+
+`);
+}
+//# sourceMappingURL=help.js.map

package/dist/commands/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,MAAM,UAAU,SAAS;IACvB,OAAO,CAAC,GAAG,CAAC;mBACK,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiGzB,CAAC,CAAC;AACH,CAAC"}

package/dist/commands/init.js

@@ -0,0 +1,73 @@
+import path from "path";
+import fs from "fs";
+import { runProjectSetupPrompts } from "../prompts/projectSetup.js";
+import { generateReactStarter } from "../generators/frontend/react.js";
+import { generateExpressStarter } from "../generators/backend/express.js";
+import { generateAuthServer } from "../generators/auth/auth.js";
+import { configureApiEnv, configureWebEnv } from "../core/configure.js";
+import { configureAuthLocalEnv, generateDockerCompose, } from "../generators/docker/docker.js";
+import { printSuccessOutput } from "../core/output.js";
+import { generateSeamlessConfig } from "../generators/config/config.js";
+export async function runCLI(projectName) {
+    const cwd = process.cwd();
+    let root = cwd;
+    if (projectName) {
+        root = path.join(cwd, projectName);
+        if (fs.existsSync(root)) {
+            throw new Error(`Directory already exists: ${projectName}`);
+        }
+        fs.mkdirSync(root);
+        console.log(`Creating project in ${root}`);
+    }
+    const files = fs.readdirSync(root);
+    const isEmpty = files.length === 0;
+    if (!isEmpty) {
+        console.log("Existing project detected.");
+        console.log("Integration flow coming next.");
+        return;
+    }
+    const answers = await runProjectSetupPrompts();
+    if (answers.web && answers.webFramework === "react") {
+        await generateReactStarter({ root });
+    }
+    if (answers.api && answers.apiFramework === "express") {
+        await generateExpressStarter({ root });
+    }
+    let sharedConfig = {};
+    if (answers.authMode === "local") {
+        await generateAuthServer({ root }, "local");
+        sharedConfig = await configureAuthLocalEnv(root);
+    }
+    if (answers.useDocker) {
+        const dockerShared = await generateDockerCompose(root, {
+            authMode: answers.authMode,
+            adminMode: answers.adminMode,
+            includeAdmin: answers.includeAdmin,
+        });
+        if (answers.authMode === "docker") {
+            sharedConfig = dockerShared;
+        }
+    }
+    if (answers.api) {
+        configureApiEnv(root, sharedConfig);
+    }
+    if (answers.web) {
+        configureWebEnv(root);
+    }
+    generateSeamlessConfig(root, {
+        projectName,
+        webFramework: answers.webFramework,
+        apiFramework: answers.apiFramework,
+        authMode: answers.authMode,
+        adminMode: answers.adminMode,
+    });
+    printSuccessOutput({
+        projectName,
+        root,
+        webFramework: answers.webFramework,
+        apiFramework: answers.apiFramework,
+        authMode: answers.authMode,
+        useDocker: answers.useDocker,
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/core/bootstrapSecret.js

@@ -0,0 +1,31 @@
+import fs from "fs";
+import path from "path";
+export function resolveBootstrapSecret() {
+    const root = process.cwd();
+    if (process.env.SEAMLESS_BOOTSTRAP_SECRET) {
+        return process.env.SEAMLESS_BOOTSTRAP_SECRET;
+    }
+    const rootEnv = path.join(root, ".env");
+    if (fs.existsSync(rootEnv)) {
+        const content = fs.readFileSync(rootEnv, "utf-8");
+        const match = content.match(/SEAMLESS_BOOTSTRAP_SECRET=(.*)/);
+        if (match)
+            return match[1].trim();
+    }
+    const authEnv = path.join(root, "auth", ".env");
+    if (fs.existsSync(authEnv)) {
+        const content = fs.readFileSync(authEnv, "utf-8");
+        const match = content.match(/SEAMLESS_BOOTSTRAP_SECRET=(.*)/);
+        if (match)
+            return match[1].trim();
+    }
+    const compose = path.join(root, "docker-compose.yml");
+    if (fs.existsSync(compose)) {
+        const content = fs.readFileSync(compose, "utf-8");
+        const match = content.match(/SEAMLESS_BOOTSTRAP_SECRET:\s*(.*)/);
+        if (match)
+            return match[1].trim();
+    }
+    return null;
+}
+//# sourceMappingURL=bootstrapSecret.js.map

package/dist/core/bootstrapSecret.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrapSecret.js","sourceRoot":"","sources":["../../src/core/bootstrapSecret.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,UAAU,sBAAsB;IACpC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAE3B,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,CAAC;QAC1C,OAAO,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;IAC/C,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAC9D,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACpC,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAC9D,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACpC,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;IACtD,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAElD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACjE,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACpC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}