create-indiepub 0.0.0

package/dist/index.js

@@ -0,0 +1,538 @@
+#!/usr/bin/env node
+#!/usr/bin/env node
+
+// src/index.ts
+import * as p from "@clack/prompts";
+
+// src/scaffold.ts
+import { mkdir, writeFile } from "fs/promises";
+import { dirname, join } from "path";
+import { downloadTemplate } from "giget";
+async function write(base, relPath, content) {
+  const full = join(base, relPath);
+  await mkdir(dirname(full), { recursive: true });
+  await writeFile(full, content, "utf-8");
+}
+function slugify(str) {
+  return str.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+}
+var codeberg = (input) => {
+  const parts = input.split("/");
+  const owner = parts[0];
+  const repo = parts[1];
+  const subdir = parts.slice(2).join("/");
+  return {
+    name: input,
+    tar: `https://codeberg.org/${owner}/${repo}/archive/main.tar.gz`,
+    subdir: subdir ? `${repo}/${subdir}` : repo
+  };
+};
+function genPackageJson(cfg) {
+  const name = slugify(cfg.dir.replace(/^\.\//, "")) || "my-indiepub-site";
+  const baseDeps = {
+    "@astrojs/cloudflare": "^12.0.0",
+    "@iconify-json/lucide": "^1.2.0",
+    "@indiepub/admin": "^0.1.0",
+    "@indiepub/astro": "^0.1.0",
+    "astro": "^5.0.0",
+    "astro-icon": "^1.1.5",
+    "drizzle-orm": "^0.38.0",
+    "nanoid": "^5.0.0"
+  };
+  const baseDevDeps = {
+    "@astrojs/check": "^0.9.0",
+    "@cloudflare/workers-types": "^4.0.0",
+    "@indiepub/types": "^0.1.0",
+    "typescript": "^5.0.0",
+    "wrangler": "^4.0.0"
+  };
+  let deps;
+  let devDeps;
+  if (cfg.template === "minimal") {
+    deps = {
+      "@astrojs/cloudflare": "^12.0.0",
+      "@indiepub/admin": "^0.1.0",
+      "@indiepub/astro": "^0.1.0",
+      "astro": "^5.0.0"
+    };
+    devDeps = {
+      "@cloudflare/workers-types": "^4.0.0",
+      "typescript": "^5.0.0",
+      "wrangler": "^4.0.0"
+    };
+  } else if (cfg.template === "byline") {
+    deps = {
+      ...baseDeps,
+      "@indiepub/db": "^0.1.0",
+      "@tiptap/core": "^3.20.0",
+      "@tiptap/extension-image": "^3.20.0",
+      "@tiptap/extension-link": "^3.20.0",
+      "@tiptap/extension-placeholder": "^3.20.0",
+      "@tiptap/starter-kit": "^3.20.0",
+      "tiptap-markdown": "^0.9.0"
+    };
+    devDeps = { ...baseDevDeps };
+  } else if (cfg.template === "timeline") {
+    deps = {
+      ...baseDeps,
+      "@iconify-json/simple-icons": "^1.0.0"
+    };
+    devDeps = { ...baseDevDeps };
+  } else {
+    deps = { ...baseDeps };
+    if (cfg.subscriptions) {
+      deps["@indiepub/email"] = "^0.1.0";
+    }
+    devDeps = { ...baseDevDeps };
+  }
+  return JSON.stringify(
+    {
+      name,
+      version: "0.0.1",
+      type: "module",
+      scripts: {
+        dev: "astro dev",
+        build: "astro build",
+        preview: "astro preview",
+        "db:migrate": "wrangler d1 migrations apply DB --local",
+        typecheck: "astro check"
+      },
+      dependencies: deps,
+      devDependencies: devDeps
+    },
+    null,
+    2
+  ) + "\n";
+}
+function genAstroConfig(cfg) {
+  const siteUrl = cfg.authorUrl || "https://example.com";
+  const syndicationLines = [];
+  if (cfg.bluesky && cfg.blueskyHandle) {
+    syndicationLines.push(`      bluesky: { handle: '${cfg.blueskyHandle}' },`);
+  }
+  if (cfg.mastodon && cfg.mastodonInstance && cfg.mastodonHandle) {
+    syndicationLines.push(
+      `      mastodon: { instance: '${cfg.mastodonInstance}', handle: '${cfg.mastodonHandle}' },`
+    );
+  }
+  const syndicationBlock = syndicationLines.length > 0 ? `      syndication: {
+${syndicationLines.join("\n")}
+      },
+` : "";
+  const subscriptionsBlock = cfg.subscriptions ? `      subscriptions: { enabled: true },
+` : "";
+  return `import { defineConfig } from 'astro/config';
+import cloudflare from '@astrojs/cloudflare';
+import icon from 'astro-icon';
+import { indiepub } from '@indiepub/astro';
+import { indiepubAdmin } from '@indiepub/admin';
+
+export default defineConfig({
+  site: '${siteUrl}',
+  output: 'server',
+  adapter: cloudflare({
+    platformProxy: { enabled: true },
+    imageService: 'cloudflare',
+  }),
+  vite: {
+    environments: {
+      ssr: {
+        external: ['node:fs/promises', 'node:path', 'node:url', 'node:crypto'],
+      },
+    },
+  },
+  integrations: [
+    icon(),
+    indiepub({
+      title: ${JSON.stringify(cfg.title || "My IndieWeb Site")},
+      author: {
+        name: ${JSON.stringify(cfg.authorName || "Site Author")},
+        url: '${siteUrl}',
+      },
+${syndicationBlock}${subscriptionsBlock}    }),
+    indiepubAdmin(),
+  ],
+});
+`;
+}
+function genTsconfig() {
+  return JSON.stringify(
+    {
+      compilerOptions: {
+        target: "ES2022",
+        module: "ES2022",
+        moduleResolution: "bundler",
+        resolveJsonModule: true,
+        esModuleInterop: true,
+        strict: true,
+        exactOptionalPropertyTypes: true,
+        noUnusedLocals: true,
+        noUnusedParameters: true,
+        noFallthroughCasesInSwitch: true,
+        skipLibCheck: true,
+        jsx: "preserve",
+        jsxImportSource: "react",
+        allowImportingTsExtensions: true
+      },
+      include: ["src", "astro.config.mjs", ".astro/types.d.ts"]
+    },
+    null,
+    2
+  ) + "\n";
+}
+function genWranglerToml(cfg) {
+  const name = slugify(cfg.dir.replace(/^\.\//, "")) || "my-indiepub-site";
+  return `name = "${name}"
+compatibility_date = "2025-01-01"
+compatibility_flags = ["nodejs_compat"]
+pages_build_output_dir = "./dist"
+
+[[d1_databases]]
+binding = "DB"
+database_name = "${name}-db"
+database_id = "YOUR_D1_DATABASE_ID_HERE"
+
+[[r2_buckets]]
+binding = "BUCKET"
+bucket_name = "${name}-bucket"
+
+[[kv_namespaces]]
+binding = "SESSION"
+id = "YOUR_KV_NAMESPACE_ID_HERE"
+`;
+}
+function genNpmrc() {
+  return [
+    "@indiepub:registry=https://registry.indiepub.dev",
+    "//registry.indiepub.dev/:_authToken=${INDIEPUB_NPM_TOKEN}",
+    ""
+  ].join("\n");
+}
+function genDevVarsExample(cfg) {
+  const lines = [
+    "# Required: license token for @indiepub/* npm registry access",
+    "INDIEPUB_NPM_TOKEN=your-license-token-here",
+    "",
+    "# Required: secret token for Micropub / admin authentication",
+    "INDIEPUB_TOKEN=choose-a-secure-random-token",
+    ""
+  ];
+  if (cfg.bluesky) {
+    lines.push("# Bluesky syndication");
+    lines.push("BSKY_APP_PASSWORD=your-bluesky-app-password");
+    lines.push("");
+  }
+  if (cfg.mastodon) {
+    lines.push("# Mastodon syndication + ActivityPub federation");
+    lines.push("MASTODON_ACCESS_TOKEN=your-mastodon-access-token");
+    lines.push(
+      "# Generate RSA key pair: openssl genrsa 2048 | tee private.pem | openssl rsa -pubout -out public.pem"
+    );
+    lines.push(
+      'ACTIVITYPUB_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----"'
+    );
+    lines.push(
+      'ACTIVITYPUB_PUBLIC_KEY="-----BEGIN PUBLIC KEY-----\\n...\\n-----END PUBLIC KEY-----"'
+    );
+    lines.push("");
+  }
+  if (cfg.subscriptions) {
+    lines.push("# Email subscriptions (Resend)");
+    lines.push("RESEND_API_KEY=re_...");
+    lines.push("RESEND_FROM_EMAIL=Your Name <newsletter@yourdomain.com>");
+    lines.push(`SITE_TITLE=${cfg.title || "My Site"}`);
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function genDevVars(licenseToken) {
+  return [
+    "# Local dev secrets \u2014 DO NOT COMMIT (this file is gitignored)",
+    `INDIEPUB_NPM_TOKEN=${licenseToken}`,
+    "INDIEPUB_TOKEN=change-me-before-deploying",
+    ""
+  ].join("\n");
+}
+function genGitignore() {
+  return [
+    "node_modules/",
+    "dist/",
+    ".astro/",
+    ".cloudflare/",
+    ".wrangler/",
+    ".dev.vars",
+    ".dev.vars.local",
+    ".npmrc",
+    "*.local",
+    ""
+  ].join("\n");
+}
+function genGitHubWorkflow(cfg) {
+  const name = slugify(cfg.dir.replace(/^\.\//, "")) || "my-indiepub-site";
+  return `name: Deploy to Cloudflare Pages
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+# Required repository secrets:
+#   CLOUDFLARE_API_TOKEN  \u2014 Cloudflare API token with Pages:Edit permission
+#   CLOUDFLARE_ACCOUNT_ID \u2014 your Cloudflare account ID
+#   INDIEPUB_TOKEN        \u2014 your IndiePub admin token (same as .dev.vars)
+#   NPM_TOKEN             \u2014 your IndiePub license token for @indiepub/* packages
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      deployments: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: pnpm
+
+      - name: Configure private registry
+        run: |
+          echo "@indiepub:registry=https://registry.indiepub.dev" >> .npmrc
+          echo "//registry.indiepub.dev/:_authToken=\${{ secrets.NPM_TOKEN }}" >> .npmrc
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build
+        run: pnpm build
+
+      - name: Deploy
+        uses: cloudflare/wrangler-action@v3
+        with:
+          apiToken: \${{ secrets.CLOUDFLARE_API_TOKEN }}
+          accountId: \${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+          command: pages deploy dist --project-name=${name}
+`;
+}
+async function scaffold(cfg) {
+  const base = cfg.dir;
+  if (cfg.template !== "minimal") {
+    await downloadTemplate(`codeberg:indiepub/themes/${cfg.template}`, {
+      dir: base,
+      force: true,
+      providers: { codeberg }
+    });
+  }
+  const files = [
+    write(base, "package.json", genPackageJson(cfg)),
+    write(base, "astro.config.mjs", genAstroConfig(cfg)),
+    write(base, "tsconfig.json", genTsconfig()),
+    write(base, "wrangler.toml", genWranglerToml(cfg)),
+    write(base, ".npmrc", genNpmrc()),
+    write(base, ".gitignore", genGitignore()),
+    write(base, ".dev.vars.example", genDevVarsExample(cfg)),
+    write(base, ".dev.vars", genDevVars(cfg.licenseToken))
+  ];
+  if (cfg.template === "minimal") {
+    files.push(write(base, "src/env.d.ts", `/// <reference types="astro/client" />
+`));
+  }
+  if (cfg.githubActions) {
+    files.push(write(base, ".github/workflows/deploy.yml", genGitHubWorkflow(cfg)));
+  }
+  await Promise.all(files);
+}
+
+// src/index.ts
+async function main() {
+  console.log();
+  p.intro(" create-indiepub ");
+  const answers = await p.group(
+    {
+      dir: () => p.text({
+        message: "Where should we create your project?",
+        placeholder: "./my-site",
+        validate: (v) => {
+          if (!v || v.trim() === "") return "Please enter a directory path";
+          if (/\s/.test(v)) return "Path cannot contain spaces";
+        }
+      }),
+      template: () => p.select({
+        message: "Which template?",
+        options: [
+          {
+            value: "default",
+            label: "Default",
+            hint: "dev-focused IndieWeb site; all post types, public-facing pages + admin"
+          },
+          {
+            value: "byline",
+            label: "Byline",
+            hint: "writer-focused blog; TipTap editor, /write dashboard, redirects UI"
+          },
+          {
+            value: "timeline",
+            label: "Timeline",
+            hint: "feed-based social media profile; unified timeline, left sidebar, interaction counts"
+          },
+          {
+            value: "minimal",
+            label: "Minimal",
+            hint: "bare config only; bring your own pages"
+          }
+        ]
+      }),
+      title: () => p.text({
+        message: "Site title",
+        placeholder: "My IndieWeb Site",
+        defaultValue: "My IndieWeb Site"
+      }),
+      authorName: () => p.text({
+        message: "Your name (shown as author)",
+        placeholder: "Jane Doe"
+      }),
+      authorUrl: () => p.text({
+        message: "Your site URL",
+        placeholder: "https://example.com",
+        defaultValue: "https://example.com"
+      }),
+      licenseToken: () => p.password({
+        message: "License token  (from indiepub.dev/account)",
+        validate: (v) => {
+          if (!v || v.trim() === "") return "A license token is required to install @indiepub/* packages";
+        }
+      }),
+      bluesky: () => p.confirm({ message: "Enable Bluesky syndication?", initialValue: false }),
+      blueskyHandle: ({ results }) => {
+        if (!results.bluesky) return void 0;
+        return p.text({
+          message: "Your Bluesky handle",
+          placeholder: "you.bsky.social"
+        });
+      },
+      mastodon: () => p.confirm({
+        message: "Enable Mastodon syndication + ActivityPub federation?",
+        initialValue: false
+      }),
+      mastodonInstance: ({ results }) => {
+        if (!results.mastodon) return void 0;
+        return p.text({
+          message: "Mastodon instance domain",
+          placeholder: "mastodon.social"
+        });
+      },
+      mastodonHandle: ({ results }) => {
+        if (!results.mastodon) return void 0;
+        return p.text({
+          message: "Your Mastodon handle (without @)",
+          placeholder: "yourhandle"
+        });
+      },
+      subscriptions: () => p.confirm({ message: "Enable email subscriptions / newsletter?", initialValue: false }),
+      githubActions: () => p.confirm({ message: "Generate GitHub Actions deploy workflow?", initialValue: true })
+    },
+    {
+      onCancel: () => {
+        p.cancel("Setup cancelled.");
+        process.exit(0);
+      }
+    }
+  );
+  const template = answers.template;
+  const cfg = {
+    dir: answers.dir,
+    template,
+    title: answers.title,
+    authorName: answers.authorName,
+    authorUrl: answers.authorUrl,
+    licenseToken: answers.licenseToken,
+    bluesky: answers.bluesky,
+    blueskyHandle: answers.blueskyHandle,
+    mastodon: answers.mastodon,
+    mastodonInstance: answers.mastodonInstance,
+    mastodonHandle: answers.mastodonHandle,
+    subscriptions: answers.subscriptions,
+    githubActions: answers.githubActions
+  };
+  const spinner2 = p.spinner();
+  spinner2.start(
+    cfg.template === "minimal" ? "Scaffolding project files\u2026" : `Cloning ${cfg.template} theme and scaffolding project\u2026`
+  );
+  try {
+    await scaffold(cfg);
+    spinner2.stop("Project files created!");
+  } catch (err) {
+    spinner2.error("Failed to scaffold project");
+    p.log.error(String(err));
+    process.exit(1);
+  }
+  const nextStepsDefault = [
+    `cd ${cfg.dir}`,
+    `cp .dev.vars.example .dev.vars   # add your secrets`,
+    ``,
+    `# Create your D1 database:`,
+    `npx wrangler d1 create <your-db-name>`,
+    `# Copy the database_id into wrangler.toml`,
+    ``,
+    `pnpm install`,
+    `pnpm db:migrate`,
+    `pnpm dev`,
+    ``,
+    `# Then visit /admin/onboarding to finish setup`
+  ];
+  const nextStepsByline = [
+    `cd ${cfg.dir}`,
+    `cp .dev.vars.example .dev.vars   # add your secrets`,
+    ``,
+    `# Create your D1 database:`,
+    `npx wrangler d1 create <your-db-name>`,
+    `# Copy the database_id into wrangler.toml`,
+    ``,
+    `pnpm install`,
+    `pnpm db:migrate`,
+    `pnpm dev`,
+    ``,
+    `# Visit /admin/onboarding to finish setup`,
+    `# Visit /write to start writing`
+  ];
+  const nextStepsTimeline = [
+    `cd ${cfg.dir}`,
+    `cp .dev.vars.example .dev.vars   # add your secrets`,
+    ``,
+    `# Create your D1 database:`,
+    `npx wrangler d1 create <your-db-name>`,
+    `# Copy the database_id into wrangler.toml`,
+    ``,
+    `pnpm install`,
+    `pnpm db:migrate`,
+    `pnpm dev`,
+    ``,
+    `# Then visit /admin/onboarding to finish setup`
+  ];
+  const nextStepsMinimal = [
+    `cd ${cfg.dir}`,
+    `cp .dev.vars.example .dev.vars   # add your secrets`,
+    ``,
+    `# Create your D1 database:`,
+    `npx wrangler d1 create <your-db-name>`,
+    `# Copy the database_id into wrangler.toml`,
+    ``,
+    `# Add your pages to src/ before running pnpm dev`,
+    ``,
+    `pnpm install`,
+    `pnpm db:migrate`,
+    `pnpm dev`
+  ];
+  const nextSteps = template === "byline" ? nextStepsByline : template === "timeline" ? nextStepsTimeline : template === "minimal" ? nextStepsMinimal : nextStepsDefault;
+  p.note(nextSteps.join("\n"), "Next steps");
+  p.outro("Happy publishing!  https://indiepub.dev");
+}
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "create-indiepub",
+  "version": "0.0.0",
+  "type": "module",
+  "bin": {
+    "create-indiepub": "./dist/index.js"
+  },
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@clack/prompts": "^1.0.1",
+    "giget": "^3.1.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "create",
+    "indiepub",
+    "indieweb",
+    "astro"
+  ],
+  "packageManager": "pnpm@10.30.3+sha512.c961d1e0a2d8e354ecaa5166b822516668b7f44cb5bd95122d590dd81922f606f5473b6d23ec4a5be05e7fcd18e8488d47d978bbe981872f1145d06e9a740017"
+}