create-joist-app 0.0.1

package/build/helpers/is-folder-empty.test.js

@@ -0,0 +1,38 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const is_folder_empty_1 = require("./is-folder-empty");
+describe("isFolderEmpty", () => {
+    let tempDir;
+    beforeEach(() => {
+        tempDir = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), "joist-test-"));
+    });
+    afterEach(() => {
+        fs_1.default.rmSync(tempDir, { recursive: true, force: true });
+    });
+    it("returns true for empty directory", () => {
+        expect((0, is_folder_empty_1.isFolderEmpty)(tempDir)).toBe(true);
+    });
+    it("returns false for non-empty directory", () => {
+        fs_1.default.writeFileSync(path_1.default.join(tempDir, "test.txt"), "hello");
+        expect((0, is_folder_empty_1.isFolderEmpty)(tempDir)).toBe(false);
+    });
+    it("ignores allowed files like .DS_Store", () => {
+        fs_1.default.writeFileSync(path_1.default.join(tempDir, ".DS_Store"), "");
+        expect((0, is_folder_empty_1.isFolderEmpty)(tempDir)).toBe(true);
+    });
+    it("ignores .git directory", () => {
+        fs_1.default.mkdirSync(path_1.default.join(tempDir, ".git"));
+        expect((0, is_folder_empty_1.isFolderEmpty)(tempDir)).toBe(true);
+    });
+    it("ignores .gitignore", () => {
+        fs_1.default.writeFileSync(path_1.default.join(tempDir, ".gitignore"), "");
+        expect((0, is_folder_empty_1.isFolderEmpty)(tempDir)).toBe(true);
+    });
+});
+//# sourceMappingURL=is-folder-empty.test.js.map

package/build/helpers/is-folder-empty.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-folder-empty.test.js","sourceRoot":"","sources":["../../src/helpers/is-folder-empty.test.ts"],"names":[],"mappings":";;;;;AAAA,4CAAoB;AACpB,4CAAoB;AACpB,gDAAwB;AACxB,uDAAkD;AAElD,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,IAAI,OAAe,CAAC;IAEpB,UAAU,CAAC,GAAG,EAAE;QACd,OAAO,GAAG,YAAE,CAAC,WAAW,CAAC,cAAI,CAAC,IAAI,CAAC,YAAE,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,YAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,IAAA,+BAAa,EAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,YAAE,CAAC,aAAa,CAAC,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;QAC1D,MAAM,CAAC,IAAA,+BAAa,EAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,YAAE,CAAC,aAAa,CAAC,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC;QACtD,MAAM,CAAC,IAAA,+BAAa,EAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,YAAE,CAAC,SAAS,CAAC,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,IAAA,+BAAa,EAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAC5B,YAAE,CAAC,aAAa,CAAC,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,EAAE,CAAC,CAAC;QACvD,MAAM,CAAC,IAAA,+BAAa,EAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/helpers/is-writeable.d.ts

@@ -0,0 +1,2 @@
+export declare function isWriteable(directory: string): Promise<boolean>;
+//# sourceMappingURL=is-writeable.d.ts.map

package/build/helpers/is-writeable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-writeable.d.ts","sourceRoot":"","sources":["../../src/helpers/is-writeable.ts"],"names":[],"mappings":"AAEA,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOrE"}

package/build/helpers/is-writeable.js

@@ -0,0 +1,17 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isWriteable = isWriteable;
+const fs_1 = __importDefault(require("fs"));
+async function isWriteable(directory) {
+    try {
+        await fs_1.default.promises.access(directory, fs_1.default.constants.W_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=is-writeable.js.map

package/build/helpers/is-writeable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-writeable.js","sourceRoot":"","sources":["../../src/helpers/is-writeable.ts"],"names":[],"mappings":";;;;;AAEA,kCAOC;AATD,4CAAoB;AAEb,KAAK,UAAU,WAAW,CAAC,SAAiB;IACjD,IAAI,CAAC;QACH,MAAM,YAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,YAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/build/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/build/index.js

@@ -0,0 +1,213 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const picocolors_1 = __importDefault(require("picocolors"));
+const prompts_1 = __importDefault(require("prompts"));
+const validate_npm_package_name_1 = __importDefault(require("validate-npm-package-name"));
+const create_app_1 = require("./create-app");
+const get_package_manager_1 = require("./helpers/get-package-manager");
+const is_folder_empty_1 = require("./helpers/is-folder-empty");
+const is_writeable_1 = require("./helpers/is-writeable");
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const packageJson = JSON.parse(fs_1.default.readFileSync(path_1.default.join(__dirname, "..", "package.json"), "utf-8"));
+async function main() {
+    const program = new commander_1.Command()
+        .name("create-joist-app")
+        .version(packageJson.version)
+        .description("Create a new Joist ORM project")
+        .argument("[project-directory]", "Directory to create the project in")
+        .option("-t, --template <template>", "Template to use (basic, graphql)", "basic")
+        .option("--use-yarn", "Use Yarn as the package manager")
+        .option("--use-npm", "Use npm as the package manager")
+        .option("--use-pnpm", "Use pnpm as the package manager")
+        .option("--use-bun", "Use Bun as the package manager")
+        .option("--skip-install", "Skip installing dependencies")
+        .option("-y, --yes", "Use default options (non-interactive mode)")
+        .option("--db-host <host>", "Database host", "localhost")
+        .option("--db-port <port>", "Database port", "5432")
+        .option("--db-user <user>", "Database user")
+        .option("--db-password <password>", "Database password", "local")
+        .option("--db-name <name>", "Database name")
+        .parse(process.argv);
+    const opts = program.opts();
+    let projectPath = program.args[0];
+    console.log();
+    console.log(picocolors_1.default.bold(picocolors_1.default.cyan("create-joist-app")), picocolors_1.default.gray(`v${packageJson.version}`));
+    console.log();
+    // Handle ctrl+c gracefully
+    prompts_1.default.override({ onCancel: () => process.exit(1) });
+    // Prompt for project directory if not provided
+    if (!projectPath) {
+        if (opts.yes) {
+            console.error(picocolors_1.default.red("Error: Project directory is required in non-interactive mode"));
+            process.exit(1);
+        }
+        const response = await (0, prompts_1.default)({
+            type: "text",
+            name: "projectPath",
+            message: "What is your project named?",
+            initial: "my-joist-app",
+            validate: (value) => {
+                const validation = (0, validate_npm_package_name_1.default)(path_1.default.basename(value));
+                if (!validation.validForNewPackages) {
+                    return `Invalid project name: ${validation.errors?.[0] || validation.warnings?.[0]}`;
+                }
+                return true;
+            },
+        });
+        if (!response.projectPath) {
+            console.log(picocolors_1.default.red("Cancelled."));
+            process.exit(1);
+        }
+        projectPath = response.projectPath;
+    }
+    // Resolve absolute path
+    const resolvedPath = path_1.default.resolve(projectPath);
+    const projectName = path_1.default.basename(resolvedPath);
+    // Validate project name
+    const validation = (0, validate_npm_package_name_1.default)(projectName);
+    if (!validation.validForNewPackages) {
+        console.error(picocolors_1.default.red(`Invalid project name "${projectName}"`));
+        console.error(picocolors_1.default.red(validation.errors?.[0] || validation.warnings?.[0] || "Unknown error"));
+        process.exit(1);
+    }
+    // Check if directory is writeable
+    const parentDir = path_1.default.dirname(resolvedPath);
+    if (!fs_1.default.existsSync(parentDir)) {
+        console.error(picocolors_1.default.red(`Parent directory does not exist: ${parentDir}`));
+        process.exit(1);
+    }
+    if (!(await (0, is_writeable_1.isWriteable)(parentDir))) {
+        console.error(picocolors_1.default.red(`Cannot write to directory: ${parentDir}`));
+        process.exit(1);
+    }
+    // Create directory if it doesn't exist
+    if (!fs_1.default.existsSync(resolvedPath)) {
+        fs_1.default.mkdirSync(resolvedPath, { recursive: true });
+    }
+    // Check if directory is empty
+    if (!(0, is_folder_empty_1.isFolderEmpty)(resolvedPath)) {
+        console.error(picocolors_1.default.red(`Directory is not empty: ${resolvedPath}`));
+        process.exit(1);
+    }
+    // Determine template
+    let template = opts.template || "basic";
+    if (!opts.yes && !opts.template) {
+        const response = await (0, prompts_1.default)({
+            type: "select",
+            name: "template",
+            message: "Which template would you like to use?",
+            choices: [
+                { title: "Basic", value: "basic", description: "A minimal Joist project with entities" },
+                {
+                    title: "GraphQL",
+                    value: "graphql",
+                    description: "Joist with GraphQL server and resolvers",
+                },
+            ],
+            initial: 0,
+        });
+        if (!response.template) {
+            console.log(picocolors_1.default.red("Cancelled."));
+            process.exit(1);
+        }
+        template = response.template;
+    }
+    // Determine package manager
+    let packageManager;
+    if (opts.useYarn) {
+        packageManager = "yarn";
+    }
+    else if (opts.useNpm) {
+        packageManager = "npm";
+    }
+    else if (opts.usePnpm) {
+        packageManager = "pnpm";
+    }
+    else if (opts.useBun) {
+        packageManager = "bun";
+    }
+    else {
+        packageManager = (0, get_package_manager_1.getPackageManager)();
+    }
+    // Get database configuration
+    let dbConfig = {
+        host: opts.dbHost || "localhost",
+        port: opts.dbPort || "5432",
+        user: opts.dbUser || projectName.replace(/-/g, "_") + "_user",
+        password: opts.dbPassword || "local",
+        name: opts.dbName || projectName.replace(/-/g, "_"),
+    };
+    if (!opts.yes) {
+        const response = await (0, prompts_1.default)([
+            {
+                type: "text",
+                name: "dbName",
+                message: "Database name:",
+                initial: dbConfig.name,
+            },
+            {
+                type: "text",
+                name: "dbUser",
+                message: "Database user:",
+                initial: dbConfig.user,
+            },
+        ]);
+        if (response.dbName === undefined) {
+            console.log(picocolors_1.default.red("Cancelled."));
+            process.exit(1);
+        }
+        dbConfig = {
+            ...dbConfig,
+            name: response.dbName || dbConfig.name,
+            user: response.dbUser || dbConfig.user,
+        };
+    }
+    console.log();
+    console.log(`Creating a new Joist app in ${picocolors_1.default.green(resolvedPath)}`);
+    console.log();
+    try {
+        await (0, create_app_1.createApp)({
+            projectPath: resolvedPath,
+            projectName,
+            template,
+            packageManager,
+            skipInstall: opts.skipInstall || false,
+            dbConfig,
+        });
+        console.log();
+        console.log(picocolors_1.default.green("Success!"), `Created ${picocolors_1.default.bold(projectName)} at ${resolvedPath}`);
+        console.log();
+        console.log("Inside that directory, you can run several commands:");
+        console.log();
+        console.log(picocolors_1.default.cyan(`  ${packageManager}${packageManager === "npm" ? " run" : ""} db`));
+        console.log("    Start the database, run migrations, and generate code.");
+        console.log();
+        console.log(picocolors_1.default.cyan(`  ${packageManager}${packageManager === "npm" ? " run" : ""} test`));
+        console.log("    Run the test suite.");
+        console.log();
+        console.log(picocolors_1.default.cyan(`  ${packageManager}${packageManager === "npm" ? " run" : ""} build`));
+        console.log("    Build the project for production.");
+        console.log();
+        console.log("We suggest that you begin by typing:");
+        console.log();
+        console.log(picocolors_1.default.cyan(`  cd ${projectPath}`));
+        console.log(picocolors_1.default.cyan(`  ${packageManager}${packageManager === "npm" ? " run" : ""} db`));
+        console.log();
+    }
+    catch (error) {
+        console.error(picocolors_1.default.red("Error creating project:"));
+        console.error(error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+main().catch((error) => {
+    console.error(error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

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

package/build/replace-sentinels.d.ts

@@ -0,0 +1,2 @@
+export declare function replaceSentinelValues(dirPath: string, replacements: Record<string, string>): void;
+//# sourceMappingURL=replace-sentinels.d.ts.map

package/build/replace-sentinels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace-sentinels.d.ts","sourceRoot":"","sources":["../src/replace-sentinels.ts"],"names":[],"mappings":"AAGA,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CA0BjG"}

package/build/replace-sentinels.js

@@ -0,0 +1,59 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.replaceSentinelValues = replaceSentinelValues;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+function replaceSentinelValues(dirPath, replacements) {
+    const entries = fs_1.default.readdirSync(dirPath, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path_1.default.join(dirPath, entry.name);
+        if (entry.isDirectory()) {
+            if (entry.name !== "node_modules" && entry.name !== ".git" && entry.name !== "codegen") {
+                replaceSentinelValues(fullPath, replacements);
+            }
+        }
+        else if (isTextFile(entry.name)) {
+            let content = fs_1.default.readFileSync(fullPath, "utf-8");
+            let modified = false;
+            for (const [sentinel, replacement] of Object.entries(replacements)) {
+                if (content.includes(sentinel)) {
+                    content = content.split(sentinel).join(replacement);
+                    modified = true;
+                }
+            }
+            if (modified) {
+                fs_1.default.writeFileSync(fullPath, content);
+            }
+        }
+    }
+}
+function isTextFile(filename) {
+    const textExtensions = [
+        ".ts",
+        ".tsx",
+        ".js",
+        ".jsx",
+        ".json",
+        ".md",
+        ".yml",
+        ".yaml",
+        ".env",
+        ".gitignore",
+        ".dockerignore",
+        ".sql",
+        ".graphql",
+        ".gql",
+        ".sh",
+        ".template",
+    ];
+    const basename = path_1.default.basename(filename).toLowerCase();
+    if (basename === "dockerfile" || basename === "db.dockerfile" || basename === "gitignore" || basename === ".env") {
+        return true;
+    }
+    const ext = path_1.default.extname(filename).toLowerCase();
+    return textExtensions.includes(ext);
+}
+//# sourceMappingURL=replace-sentinels.js.map

package/build/replace-sentinels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace-sentinels.js","sourceRoot":"","sources":["../src/replace-sentinels.ts"],"names":[],"mappings":";;;;;AAGA,sDA0BC;AA7BD,4CAAoB;AACpB,gDAAwB;AAExB,SAAgB,qBAAqB,CAAC,OAAe,EAAE,YAAoC;IACzF,MAAM,OAAO,GAAG,YAAE,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAEjE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAEhD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvF,qBAAqB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;aAAM,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,IAAI,OAAO,GAAG,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACjD,IAAI,QAAQ,GAAG,KAAK,CAAC;YAErB,KAAK,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;gBACnE,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC/B,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;oBACpD,QAAQ,GAAG,IAAI,CAAC;gBAClB,CAAC;YACH,CAAC;YAED,IAAI,QAAQ,EAAE,CAAC;gBACb,YAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,QAAgB;IAClC,MAAM,cAAc,GAAG;QACrB,KAAK;QACL,MAAM;QACN,KAAK;QACL,MAAM;QACN,OAAO;QACP,KAAK;QACL,MAAM;QACN,OAAO;QACP,MAAM;QACN,YAAY;QACZ,eAAe;QACf,MAAM;QACN,UAAU;QACV,MAAM;QACN,KAAK;QACL,WAAW;KACZ,CAAC;IAEF,MAAM,QAAQ,GAAG,cAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IAEvD,IAAI,QAAQ,KAAK,YAAY,IAAI,QAAQ,KAAK,eAAe,IAAI,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACjH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACjD,OAAO,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC"}

package/build/update-package-json.d.ts

@@ -0,0 +1,2 @@
+export declare function updatePackageJson(projectPath: string, projectName: string): void;
+//# sourceMappingURL=update-package-json.d.ts.map

package/build/update-package-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-package-json.d.ts","sourceRoot":"","sources":["../src/update-package-json.ts"],"names":[],"mappings":"AAEA,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAehF"}

package/build/update-package-json.js

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updatePackageJson = updatePackageJson;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+function updatePackageJson(projectPath, projectName) {
+    const pkgJsonPath = path_1.default.join(projectPath, "package.json");
+    if (!fs_1.default.existsSync(pkgJsonPath))
+        return;
+    const pkgJson = JSON.parse(fs_1.default.readFileSync(pkgJsonPath, "utf-8"));
+    pkgJson.name = projectName;
+    // Add db/migration scripts that reference the user's DB config
+    pkgJson.scripts = {
+        ...pkgJson.scripts,
+        db: "docker compose up -d --wait db && yarn migrate && yarn codegen",
+        redb: "docker compose exec db ./reset.sh && yarn migrate && yarn codegen",
+        migrate: "env-cmd joist-pg-migrate",
+        "migrate:new": "env-cmd joist-pg-migrate create",
+    };
+    fs_1.default.writeFileSync(pkgJsonPath, JSON.stringify(pkgJson, null, 2) + "\n");
+}
+//# sourceMappingURL=update-package-json.js.map

package/build/update-package-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-package-json.js","sourceRoot":"","sources":["../src/update-package-json.ts"],"names":[],"mappings":";;;;;AAEA,8CAeC;AAjBD,4CAAoB;AACpB,gDAAwB;AACxB,SAAgB,iBAAiB,CAAC,WAAmB,EAAE,WAAmB;IACxE,MAAM,WAAW,GAAG,cAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAC3D,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO;IAExC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAE,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IAClE,OAAO,CAAC,IAAI,GAAG,WAAW,CAAC;IAC3B,+DAA+D;IAC/D,OAAO,CAAC,OAAO,GAAG;QAChB,GAAG,OAAO,CAAC,OAAO;QAClB,EAAE,EAAE,gEAAgE;QACpE,IAAI,EAAE,mEAAmE;QACzE,OAAO,EAAE,0BAA0B;QACnC,aAAa,EAAE,iCAAiC;KACjD,CAAC;IACF,YAAE,CAAC,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACzE,CAAC"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "create-joist-app",
+  "version": "0.0.1",
+  "description": "Create a new Joist ORM project with a single command",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/joist-orm/joist-orm.git",
+    "directory": "packages/create-joist-app"
+  },
+  "keywords": [
+    "joist",
+    "orm",
+    "typescript",
+    "postgresql",
+    "scaffolding",
+    "cli"
+  ],
+  "main": "build/index.js",
+  "types": "build/index.d.ts",
+  "bin": "./build/index.js",
+  "files": [
+    "build",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "test:scaffolded": "./scripts/test-scaffolded-project.sh",
+    "prepublishOnly": "../../scripts/prepublish.sh",
+    "format": "prettier --write 'src/**/*.{ts,js}'"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "picocolors": "^1.1.1",
+    "prompts": "^2.4.2",
+    "validate-npm-package-name": "^6.0.2"
+  },
+  "devDependencies": {
+    "@swc/core": "^1.15.18",
+    "@swc/jest": "^0.2.39",
+    "@tsconfig/node20": "^20.1.9",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^24.11.0",
+    "@types/prompts": "^2.4.9",
+    "@types/validate-npm-package-name": "^4.0.2",
+    "jest": "30.2.0",
+    "prettier": "^3.8.1",
+    "prettier-plugin-organize-imports": "^4.3.0",
+    "typescript": "5.9.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/templates/basic/README.md

@@ -0,0 +1,70 @@
+# {{PROJECT_NAME}}
+
+A [Joist ORM](https://joist-orm.io/) project.
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js 18+
+- Docker (for PostgreSQL)
+
+### Setup
+
+1. Start the database and run initial setup:
+
+```bash
+yarn db
+```
+
+This command will:
+- Start a PostgreSQL container
+- Run database migrations
+- Generate Joist entity code
+
+### Development
+
+#### Running Tests
+
+```bash
+yarn test
+```
+
+#### Creating a New Migration
+
+```bash
+yarn migrate:new my-migration-name
+```
+
+Then edit the generated file in `migrations/` and run:
+
+```bash
+yarn migrate
+yarn codegen
+```
+
+#### Resetting the Database
+
+```bash
+yarn redb
+```
+
+### Project Structure
+
+```
+├── migrations/           # Database migrations
+├── src/
+│   ├── entities/        # Joist entities
+│   │   ├── codegen/     # Generated code (do not edit)
+│   │   └── factories/   # Test factories
+│   ├── context.ts       # Request context
+│   ├── setupTestEnv.ts  # Global test setup
+│   └── setupTests.ts    # Per-suite test setup
+├── docker-compose.yml   # PostgreSQL service
+└── joist-config.json    # Joist configuration
+```
+
+## Learn More
+
+- [Joist Documentation](https://joist-orm.io/)
+- [GitHub Repository](https://github.com/joist-orm/joist-orm)

package/templates/basic/gitignore

@@ -0,0 +1,28 @@
+# Dependencies
+node_modules/
+
+# Build output
+build/
+dist/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Test output
+coverage/
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# TypeScript
+*.tsbuildinfo

package/templates/basic/jest.config.js

@@ -0,0 +1,14 @@
+/** @type {import('jest').Config} */
+module.exports = {
+  transform: {
+    "^.+\\.tsx?$": "@swc/jest",
+  },
+  moduleNameMapper: {
+    "^src/(.*)$": "<rootDir>/src/$1",
+  },
+  testMatch: ["<rootDir>/src/**/*.test.{ts,tsx}"],
+  testEnvironment: "node",
+  globalSetup: "./src/setupTestEnv.ts",
+  setupFilesAfterEnv: ["./src/setupTests.ts"],
+  maxWorkers: 1,
+};

package/templates/basic/joist-config.json

@@ -0,0 +1,7 @@
+{
+  "contextType": "Context@src/context",
+  "entities": { "Author": { "tag": "a" }, "Book": { "tag": "b" } },
+  "entitiesDirectory": "./src/entities",
+  "idType": "tagged-string",
+  "version": "0.0.0"
+}

package/templates/basic/migrations/1580658856631_initial.ts

@@ -0,0 +1,22 @@
+import {
+  createCreatedAtFunction,
+  createEntityTable,
+  createUpdatedAtFunction,
+  foreignKey,
+} from "joist-migration-utils";
+import { MigrationBuilder } from "node-pg-migrate";
+
+export function up(b: MigrationBuilder): void {
+  createUpdatedAtFunction(b);
+  createCreatedAtFunction(b);
+
+  createEntityTable(b, "authors", {
+    first_name: { type: "varchar(255)", notNull: true },
+    last_name: { type: "varchar(255)", notNull: false },
+  });
+
+  createEntityTable(b, "books", {
+    title: { type: "varchar(255)", notNull: true },
+    author_id: foreignKey("authors", { notNull: true }),
+  });
+}

package/templates/basic/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "basic-template",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "build": "tsc",
+    "test": "env-cmd jest --runInBand",
+    "codegen": "env-cmd yarn joist-codegen",
+    "format": "prettier --write \"src/**/*.{ts,tsx}\""
+  },
+  "dependencies": {
+    "@types/pg": "^8.18.0",
+    "joist-orm": "2.0.3-next.36",
+    "pg": "^8.16.3"
+  },
+  "devDependencies": {
+    "@swc/core": "^1.13.0",
+    "@swc/jest": "^0.2.39",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^24.0.0",
+    "env-cmd": "^11.0.0",
+    "jest": "^30.0.0",
+    "node-pg-migrate": "^8.0.4",
+    "prettier": "^3.6.0",
+    "tsx": "^4.20.0",
+    "typescript": "^5.9.0"
+  }
+}