The complete open source platform to run your entire marketplace. Storefront, vendor panel, admin console, and integrations in one enterprise-grade platform you own.
TypeScript b2b-marketplacecomposable-commerceecommerceenterpriseheadless-commercemarketplacemedusamedusajsmulti-vendortypescript
feat(create-mercur-app): add optional Next.js storefront step (#1286)
Viktor Holik90fbabd76d4a
diff --git a/packages/create-mercur-app/src/commands/create.ts b/packages/create-mercur-app/src/commands/create.tsindex 0ba7a37f2..e665302c0 100644--- a/packages/create-mercur-app/src/commands/create.ts+++ b/packages/create-mercur-app/src/commands/create.ts@@ -1,4 +1,5 @@import { spawn } from "node:child_process";+import os from "node:os";import { Readable } from "node:stream";import { pipeline } from "node:stream/promises";import path from "path";@@ -64,6 +65,7 @@ export const create = new Command()process.cwd()).option("--no-deps", "skip installing dependencies.")+ .option("--skip-storefront", "skip adding the Next.js storefront.", false).option("--skip-db", "skip database configuration.", false).option("--skip-email", "skip email prompt.", false).option("--db-connection-string <string>", "PostgreSQL connection string.")@@ -125,6 +127,18 @@ export const create = new Command()template = "basic";}+ let addStorefront = false;+ if (template === "basic" && !opts.skipStorefront) {+ const { wantsStorefront } = await prompts({+ type: "confirm",+ name: "wantsStorefront",+ message: `Add a ${highlighter.info("Next.js storefront")}?`,+ initial: true,+ });++ addStorefront = Boolean(wantsStorefront);+ }+if (!opts.skipEmail) {const { wantsEmail } = await prompts({type: "confirm",@@ -152,11 +166,27 @@ export const create = new Command()await createOrFindProjectDir(projectDir);const downloadSpinner = spinner("Downloading template...").start();- await downloadTemplate({- projectDir,- template: template,- });- downloadSpinner.succeed("Template downloaded successfully.");+ // Fetch the repo tarball once, then extract each subpath from it locally+ // so opting into the storefront doesn't trigger a second network download.+ const tarballPath = await downloadRepoTarball();+ try {+ await extractTemplate({ tarballPath, projectDir, template });+ downloadSpinner.succeed("Template downloaded successfully.");++ if (addStorefront) {+ const storefrontSpinner = spinner("Adding Next.js storefront...").start();+ try {+ await extractStorefront({ tarballPath, projectDir });+ storefrontSpinner.succeed("Next.js storefront added successfully.");+ } catch (error) {+ storefrontSpinner.fail(+ `Failed to add storefront${error instanceof Error ? `: ${error.message}` : ""}.`+ );+ }+ }+ } finally {+ await fs.remove(tarballPath).catch(() => null);+ }const packageManager = await resolveProjectPackageManager();await updateRootPackageJson(projectDir, projectName, packageManager);@@ -332,35 +362,88 @@ async function createOrFindProjectDir(projectDir: string): Promise<void> {}}-async function downloadTemplate({+// Downloads the repo tarball once to a temp file. Callers then extract whichever+// subpaths they need from it locally, avoiding a network fetch per directory.+async function downloadRepoTarball(): Promise<string> {+ const url = `https://codeload.github.com/mercurjs/mercur/tar.gz/${DEFAULT_BRANCH}`;+ const res = await fetch(url);++ if (!res.body) {+ throw new Error(`Failed to download: ${url}`);+ }++ const tarballPath = path.join(os.tmpdir(), `mercur-${DEFAULT_BRANCH.replaceAll("/", "-")}-${process.pid}.tar.gz`);+ await pipeline(+ Readable.from(res.body as unknown as NodeJS.ReadableStream),+ fs.createWriteStream(tarballPath)+ );++ return tarballPath;+}++// Extracts a single directory out of the local tarball. `strip` controls how many+// leading path segments are removed so files land at the right place under `cwd`.+async function extractRepoDir({+ tarballPath,+ cwd,+ repoPath,+ strip,+}: {+ tarballPath: string;+ cwd: string;+ repoPath: string;+ strip: number;+}) {+ const branchDir = `mercur-${DEFAULT_BRANCH.replace(/^v/, "").replaceAll("/", "-")}`;+ const filter = `${branchDir}/${repoPath}/`;++ await x({+ file: tarballPath,+ cwd,+ filter: (p) => p.includes(filter),+ strip,+ });+}++async function extractTemplate({+ tarballPath,projectDir,template,}: {+ tarballPath: string;projectDir: string;template: keyof typeof CREATE_TEMPLATES;}) {- const url = `https://codeload.github.com/mercurjs/mercur/tar.gz/${DEFAULT_BRANCH}`;const templatePath = CREATE_TEMPLATES[template].path;- const filter = `mercur-${DEFAULT_BRANCH.replace(/^v/, "").replaceAll("/", "-")}/templates/${templatePath}/`;-- await pipeline(- await downloadTarStream(url),- x({- cwd: projectDir,- filter: (p) => p.includes(filter),- strip: 2 + templatePath.split("/").length,- })- );+ const repoPath = `templates/${templatePath}`;++ // Drop the branch dir + every segment of `repoPath` so the template root+ // becomes the project root.+ await extractRepoDir({+ tarballPath,+ cwd: projectDir,+ repoPath,+ strip: 1 + repoPath.split("/").length,+ });}-async function downloadTarStream(url: string) {- const res = await fetch(url);-- if (!res.body) {- throw new Error(`Failed to download: ${url}`);- }-- return Readable.from(res.body as unknown as NodeJS.ReadableStream);+async function extractStorefront({+ tarballPath,+ projectDir,+}: {+ tarballPath: string;+ projectDir: string;+}) {+ await fs.ensureDir(path.join(projectDir, "apps"));++ // Drop only the branch dir so files keep their `apps/storefront/...` prefix+ // and land alongside the other workspace apps.+ await extractRepoDir({+ tarballPath,+ cwd: projectDir,+ repoPath: "apps/storefront",+ strip: 1,+ });}async function installDeps({diff --git a/packages/create-mercur-app/src/utils/manage-env-files.ts b/packages/create-mercur-app/src/utils/manage-env-files.tsindex 1d13c09a3..55061258a 100644--- a/packages/create-mercur-app/src/utils/manage-env-files.ts+++ b/packages/create-mercur-app/src/utils/manage-env-files.ts@@ -56,6 +56,7 @@ const APP_PATHS = [{ path: "packages/api" },{ path: "apps/vendor" },{ path: "apps/admin" },+ { path: "apps/storefront" },];export async function manageEnvFiles({