create-bike-blog 0.1.0

package/index.js

@@ -0,0 +1,154 @@
+#!/usr/bin/env node
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { execSync } from 'node:child_process';
+import readline from 'node:readline';
+
+// --- Template engine ---
+
+export function renderTemplate(content, vars) {
+  return content.replace(/\{\{(\w+)\}\}/g, (match, key) => {
+    return key in vars ? vars[key] : match;
+  });
+}
+
+// --- File operations ---
+
+function copyTemplate(templateDir, destDir, vars) {
+  for (const entry of fs.readdirSync(templateDir, { withFileTypes: true })) {
+    const srcPath = path.join(templateDir, entry.name);
+    const destName = entry.name.replace(/\.tpl$/, '');
+    const destPath = path.join(destDir, destName);
+
+    if (entry.isDirectory()) {
+      fs.mkdirSync(destPath, { recursive: true });
+      copyTemplate(srcPath, destPath, vars);
+    } else {
+      let content = fs.readFileSync(srcPath, 'utf-8');
+      if (entry.name.endsWith('.tpl')) {
+        content = renderTemplate(content, vars);
+      }
+      fs.writeFileSync(destPath, content);
+    }
+  }
+}
+
+// --- Prompts ---
+
+const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+const ask = (q) => new Promise((resolve) => rl.question(q, resolve));
+
+// --- Main ---
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.length < 2 || args.includes('--help') || args.includes('-h')) {
+    console.log(`
+  Usage: npx create-bike-blog <folder> <domain>
+
+  Example: npx create-bike-blog bike-blog eljojo.bike
+`);
+    process.exit(args.includes('--help') || args.includes('-h') ? 0 : 1);
+  }
+
+  const folder = args[0];
+  const domain = args[1];
+  const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+  const destDir = path.resolve(folder);
+
+  if (fs.existsSync(destDir)) {
+    console.error(`\n  Error: ${folder}/ already exists.\n`);
+    process.exit(1);
+  }
+
+  console.log(`
+  Welcome to whereto.bike!
+
+  Here's how setting up your blog works:
+
+    1. Bootstrap (you are here)
+       Creating your project in ${folder}/
+
+    2. Edit
+       Customize your config, write your about page, add some rides
+
+    3. npm run setup
+       Connects GitHub and Cloudflare so deploys work automatically
+
+    4. git push
+       Your blog is live at ${domain}!
+`);
+
+  // Create project directory
+  fs.mkdirSync(destDir, { recursive: true });
+
+  const folderName = path.basename(destDir);
+  const vars = {
+    FOLDER: folderName,
+    DOMAIN: domain,
+    TIMEZONE: timezone,
+  };
+
+  // Copy and render templates
+  const templateDir = new URL('./templates', import.meta.url).pathname;
+  copyTemplate(templateDir, destDir, vars);
+
+  // Rename dotfiles (npm strips .gitignore from published packages)
+  const renames = { gitignore: '.gitignore', gitattributes: '.gitattributes', env: '.env' };
+  for (const [from, to] of Object.entries(renames)) {
+    const src = path.join(destDir, from);
+    const dest = path.join(destDir, to);
+    if (fs.existsSync(src)) fs.renameSync(src, dest);
+  }
+
+  // Move github/ to .github/
+  const githubSrc = path.join(destDir, 'github');
+  const githubDest = path.join(destDir, '.github');
+  if (fs.existsSync(githubSrc)) {
+    fs.renameSync(githubSrc, githubDest);
+  }
+
+
+  console.log(`  Files created in ${folder}/\n`);
+
+  // Install dependencies
+  const install = await ask('  Install dependencies? (npm install) [Y/n] ');
+  if (install.toLowerCase() !== 'n') {
+    try {
+      execSync('npm install', { cwd: destDir, stdio: 'inherit' });
+    } catch {
+      console.error('\n  npm install failed. You can retry manually: cd ' + folder + ' && npm install\n');
+    }
+  } else {
+    console.log(`\n  Skipped. Run it yourself:\n\n    cd ${folder} && npm install\n`);
+  }
+
+  // Initialize git repo
+  const gitInit = await ask('  Initialize git repo? (git init + first commit) [Y/n] ');
+  if (gitInit.toLowerCase() !== 'n') {
+    execSync('git init', { cwd: destDir, stdio: 'pipe' });
+    execSync('git add -A', { cwd: destDir, stdio: 'pipe' });
+    execSync('git commit -m "initial blog scaffold"', { cwd: destDir, stdio: 'pipe' });
+    console.log('\n  ✓ Git repo initialized with first commit.\n');
+  } else {
+    console.log(`\n  Skipped. Run it yourself:\n\n    cd ${folder} && git init && git add -A && git commit -m "initial blog scaffold"\n`);
+  }
+
+  console.log(`  Next steps:
+
+    cd ${folder}
+    # edit blog/config.yml and blog/pages/about.md
+    npm run setup
+`);
+
+  rl.close();
+}
+
+// Only run when invoked directly (not when imported for tests)
+const isDirectRun = process.argv[1] &&
+  (process.argv[1].endsWith('/index.js') || process.argv[1].endsWith('/create-bike-blog'));
+if (isDirectRun) {
+  main();
+}

package/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "create-bike-blog",
+  "version": "0.1.0",
+  "description": "Scaffold a new whereto.bike cycling blog",
+  "type": "module",
+  "bin": {
+    "create-bike-blog": "./index.js"
+  },
+  "files": ["index.js", "sync.js", "templates/"],
+  "license": "AGPL-3.0"
+}

package/sync.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+
+/**
+ * Syncs template files from the whereto-bike package into your blog repo.
+ * Run from the blog repo: npm run sync
+ *
+ * Updates:
+ *   - .github/workflows/ — CI/deploy/update actions (rendered from .tpl templates)
+ *   - src/middleware.ts   — re-export of package middleware
+ *   - scripts/setup.js   — interactive setup helper
+ *   - astro.config.mjs    — Astro config
+ *   - tsconfig.json       — TypeScript config
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+
+export function renderTemplate(content, vars) {
+  return content.replace(/\{\{(\w+)\}\}/g, (match, key) => {
+    return key in vars ? vars[key] : match;
+  });
+}
+
+/** Read a top-level scalar from a simple YAML file. */
+function readYamlField(filePath, field) {
+  const content = fs.readFileSync(filePath, 'utf-8');
+  const re = new RegExp(`^${field}:\\s*["']?([^"'\\n]+?)["']?\\s*$`, 'm');
+  const match = content.match(re);
+  return match ? match[1] : '';
+}
+
+export function syncFile(srcPath, destPath, vars) {
+  let content = fs.readFileSync(srcPath, 'utf-8');
+  if (srcPath.endsWith('.tpl')) {
+    content = renderTemplate(content, vars);
+  }
+
+  const existing = fs.existsSync(destPath) ? fs.readFileSync(destPath, 'utf-8') : null;
+  if (existing !== content) {
+    fs.mkdirSync(path.dirname(destPath), { recursive: true });
+    fs.writeFileSync(destPath, content);
+    return true;
+  }
+  return false;
+}
+
+// --- Main execution (only when run directly, not when imported) ---
+const isMain = process.argv[1] && new URL(`file://${process.argv[1]}`).href === import.meta.url;
+
+if (isMain) {
+  const cwd = process.cwd();
+  const pkg = JSON.parse(fs.readFileSync(path.join(cwd, 'package.json'), 'utf-8'));
+
+  const configPath = path.join(cwd, 'blog', 'config.yml');
+  if (!fs.existsSync(configPath)) {
+    console.error(`  Error: blog/config.yml not found. Is this a bike blog repo?`);
+    process.exit(1);
+  }
+
+  const vars = {
+    FOLDER: pkg.name,
+    DOMAIN: readYamlField(configPath, 'domain'),
+    TIMEZONE: Intl.DateTimeFormat().resolvedOptions().timeZone,
+  };
+
+  const templateRoot = new URL('./templates', import.meta.url).pathname;
+  let updated = 0;
+
+  // --- Sync CI workflows (.tpl rendered) ---
+  const workflowDir = path.join(templateRoot, 'github', 'workflows');
+  const outWorkflowDir = path.join(cwd, '.github', 'workflows');
+  for (const file of fs.readdirSync(workflowDir)) {
+    const outName = file.replace(/\.tpl$/, '');
+    if (syncFile(path.join(workflowDir, file), path.join(outWorkflowDir, outName), vars)) {
+      console.log(`  updated .github/workflows/${outName}`);
+      updated++;
+    }
+  }
+
+  // --- Sync source files (copied as-is, no templating) ---
+  const sourceFiles = [
+    'src/middleware.ts',
+    'src/content.config.ts',
+    'scripts/setup.js',
+    'astro.config.mjs',
+    'tsconfig.json',
+  ];
+
+  for (const rel of sourceFiles) {
+    const srcPath = path.join(templateRoot, rel);
+    if (!fs.existsSync(srcPath)) continue;
+    if (syncFile(srcPath, path.join(cwd, rel), vars)) {
+      console.log(`  updated ${rel}`);
+      updated++;
+    }
+  }
+
+  // --- Summary ---
+  if (updated === 0) {
+    console.log('  Everything is up to date.');
+  } else {
+    console.log(`\n  ${updated} file(s) updated. Review and commit the changes.`);
+  }
+}

package/templates/astro.config.mjs

@@ -0,0 +1,17 @@
+// Auto-generated by `npm run sync` — local changes will be overwritten.
+// Astro configuration wired to the whereto-bike platform.
+import 'dotenv/config';
+import { defineConfig } from 'astro/config';
+import { getAdapter } from 'whereto-bike/lib/adapter';
+import preact from '@astrojs/preact';
+import { wheretoBike, cspConfig } from 'whereto-bike';
+
+export default defineConfig({
+  site: process.env.SITE_URL,
+  adapter: await getAdapter(process.env.RUNTIME),
+  security: cspConfig(),
+  integrations: [
+    preact(),
+    ...wheretoBike({ consumerRoot: import.meta.dirname }),
+  ],
+});

package/templates/blog/config.yml.tpl

@@ -0,0 +1,24 @@
+instance_type: blog
+name: "My Bike Blog"
+display_name: {{DOMAIN}}
+tagline: "bike rides and adventures"
+description: "A cycling blog — rides, tours, and adventures."
+domain: {{DOMAIN}}
+cdn_url: https://cdn.{{DOMAIN}}
+videos_cdn_url: https://cdn.{{DOMAIN}}
+timezone: {{TIMEZONE}}
+locale: en
+locales: [en]
+author:
+  name: ""
+  email: ""
+  url: https://{{DOMAIN}}
+center:
+  lat: 0
+  lng: 0
+bounds:
+  north: 90
+  south: -90
+  east: 180
+  west: -180
+place_categories: {}

package/templates/blog/pages/about.md

@@ -0,0 +1,4 @@
+---
+title: About
+---
+Welcome to my cycling blog! I ride bikes and write about it.

package/templates/env.tpl

@@ -0,0 +1,4 @@
+CONTENT_DIR=.
+CITY=blog
+RUNTIME=local
+SITE_URL=https://{{DOMAIN}}

package/templates/flake.nix.tpl

@@ -0,0 +1,8 @@
+{
+  description = "{{DOMAIN}} — personal cycling blog";
+
+  inputs.bike-app.url = "github:eljojo/bike-app-astro";
+
+  outputs = { bike-app, ... }:
+    bike-app.outputs;
+}

package/templates/gitattributes

@@ -0,0 +1 @@
+*.gpx filter=lfs diff=lfs merge=lfs -text

package/templates/github/workflows/ci.yml.tpl

@@ -0,0 +1,56 @@
+# Auto-generated by `npm run sync` — local changes will be overwritten.
+# Builds the site on pull requests to verify nothing is broken.
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ci-${{ github.head_ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: LFS cache period
+        id: lfs-period
+        run: echo "period=$(( $(date +%s) / 1209600 ))" >> "$GITHUB_OUTPUT"
+
+      - name: Restore LFS cache
+        uses: actions/cache@v5
+        with:
+          path: .git/lfs
+          key: lfs-${{ steps.lfs-period.outputs.period }}
+          restore-keys: lfs-
+
+      - name: Pull LFS files
+        run: git lfs pull
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 22
+          cache: 'npm'
+
+      - run: npm ci
+
+      - name: Generate map styles
+        run: npx tsx node_modules/whereto-bike/scripts/build-map-style.ts
+
+      - name: Restore Astro content cache
+        uses: actions/cache@v5
+        with:
+          path: .astro
+          key: astro-${{ hashFiles('blog/**') }}
+          restore-keys: astro-
+
+      - name: Build site
+        run: npx astro build
+        env:
+          CONTENT_DIR: .
+          CITY: blog
+          SITE_URL: https://{{DOMAIN}}
+          NODE_OPTIONS: '--max-old-space-size=4096'

package/templates/github/workflows/deploy.yml.tpl

@@ -0,0 +1,106 @@
+# Auto-generated by `npm run sync` — local changes will be overwritten.
+# Builds and deploys the site to Cloudflare Workers on push to main.
+name: Deploy
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+concurrency:
+  group: deploy
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment: production
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: LFS cache period
+        id: lfs-period
+        run: echo "period=$(( $(date +%s) / 1209600 ))" >> "$GITHUB_OUTPUT"
+
+      - name: Restore LFS cache
+        uses: actions/cache@v5
+        with:
+          path: .git/lfs
+          key: lfs-${{ steps.lfs-period.outputs.period }}
+          restore-keys: lfs-
+
+      - name: Pull LFS files
+        run: git lfs pull
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 22
+          cache: 'npm'
+
+      - run: npm ci
+
+      - name: Record build start time
+        run: echo "BUILD_START=$(date -u +%Y-%m-%dT%H:%M:%SZ)" >> "$GITHUB_ENV"
+
+      - name: Generate map styles
+        run: npx tsx node_modules/whereto-bike/scripts/build-map-style.ts
+
+      - name: Restore map cache
+        uses: actions/cache@v5
+        with:
+          path: public/maps
+          key: maps-${{ hashFiles('blog/rides/**/*.gpx', 'package-lock.json') }}
+          restore-keys: maps-
+
+      - name: Restore Astro content cache
+        uses: actions/cache@v5
+        with:
+          path: .astro
+          key: astro-${{ hashFiles('blog/**') }}
+          restore-keys: astro-
+
+      - name: Generate map thumbnails
+        run: npx tsx node_modules/whereto-bike/scripts/generate-maps.ts
+        env:
+          CONTENT_DIR: .
+          CITY: blog
+          GOOGLE_MAPS_STATIC_API_KEY: ${{ secrets.GOOGLE_MAPS_STATIC_API_KEY }}
+
+      - name: Build site
+        run: npx astro build
+        env:
+          CONTENT_DIR: .
+          CITY: blog
+          SITE_URL: https://{{DOMAIN}}
+          NODE_OPTIONS: '--max-old-space-size=4096'
+
+      - name: Prepare wrangler config
+        run: |
+          rm -f dist/server/wrangler.json
+          node -e "
+            const fs = require('fs');
+            const raw = fs.readFileSync('wrangler.jsonc', 'utf8');
+            const stripped = raw.replace(/\/\/.*$/gm, '').replace(/\/\*[\s\S]*?\*\//g, '');
+            const c = JSON.parse(stripped);
+            c.main = './dist/server/entry.mjs';
+            c.assets.directory = './dist/client';
+            fs.writeFileSync('wrangler.jsonc', JSON.stringify(c, null, 2));
+          "
+
+      - name: Run D1 migrations
+        run: npx wrangler d1 migrations apply DB --config wrangler.jsonc --remote
+        env:
+          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+
+      - name: Deploy to Cloudflare Workers
+        run: npx wrangler deploy --config wrangler.jsonc
+        env:
+          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+
+      - name: Clear stale content edits cache
+        run: npx wrangler d1 execute DB --config wrangler.jsonc --remote --command "DELETE FROM content_edits WHERE updated_at < '${{ env.BUILD_START }}'"
+        env:
+          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}

package/templates/github/workflows/update.yml.tpl

@@ -0,0 +1,59 @@
+# Auto-generated by `npm run sync` — local changes will be overwritten.
+# Weekly: updates whereto-bike, syncs templates, commits and pushes if changed.
+name: Update
+
+on:
+  schedule:
+    - cron: '0 9 * * 1' # Every Monday at 9am UTC
+  workflow_dispatch:
+
+jobs:
+  update:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: LFS cache period
+        id: lfs-period
+        run: echo "period=$(( $(date +%s) / 1209600 ))" >> "$GITHUB_OUTPUT"
+
+      - name: Restore LFS cache
+        uses: actions/cache@v5
+        with:
+          path: .git/lfs
+          key: lfs-${{ steps.lfs-period.outputs.period }}
+          restore-keys: lfs-
+
+      - name: Pull LFS files
+        run: git lfs pull
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 22
+          cache: 'npm'
+
+      - run: npm ci
+
+      - name: Update whereto-bike
+        run: npm update whereto-bike
+
+      - name: Sync workflow templates
+        run: npm run sync
+
+      - name: Check for changes
+        id: changes
+        run: |
+          if git diff --quiet; then
+            echo "updated=false" >> "$GITHUB_OUTPUT"
+          else
+            echo "updated=true" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Commit and push
+        if: steps.changes.outputs.updated == 'true'
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git add package-lock.json .github/workflows/
+          git commit -m "chore: update whereto-bike"
+          git push

package/templates/gitignore

@@ -0,0 +1,6 @@
+node_modules/
+dist/
+.astro/
+.data/
+.env
+.wrangler/

package/templates/package.json.tpl

@@ -0,0 +1,22 @@
+{
+  "name": "{{FOLDER}}",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "astro dev",
+    "build": "astro build",
+    "preview": "astro preview",
+    "setup": "node scripts/setup.js",
+    "sync": "node node_modules/whereto-bike/sync.js"
+  },
+  "dependencies": {
+    "@astrojs/cloudflare": "^13.0.0-beta.11",
+    "@astrojs/node": "^10.0.0-beta.6",
+    "@astrojs/preact": "^4.1.3",
+    "astro": "^6.0.0-beta.20",
+    "whereto-bike": "^0.0.1",
+    "dotenv": "^17.3.1",
+    "preact": "^10.28.4",
+    "sass": "^1.97.3"
+  }
+}