Adalie’s website

Next.js App Router, React, TypeScript, and Tailwind CSS, deployed to Cloudflare Workers with OpenNext. The site keeps the original photo, fonts, color scheme, and Markdown blog posts.

Development

Use Node.js 24 and npm 11 (or nvm use).

npm ci
npm run dev

Open http://localhost:3000. Docker is also available with docker compose up --build.

The dev server listens on all interfaces. For Tailscale or another remote hostname, add a comma-separated DEV_ALLOWED_ORIGINS value to a local .env.development.local file so Next.js permits dev assets and hot reload from that hostname. This local file is ignored by Git. Use npm run dev -- --port 3101 to select a different port.

npm run dev and builds prepare content automatically. After changing Markdown or adding images while the dev server is running, run npm run prepare:content again.

Cloudflare Workers

The deployment configuration is in wrangler.jsonc and open-next.config.ts. This uses Workers, not Cloudflare Pages or the old next-on-pages adapter.

npm run preview     # Build and run locally in the Workers runtime
npm run deploy      # Build and deploy using your Cloudflare login

The production Worker is adalie-website. wrangler.jsonc records the account and routes for dacubeking.com/* and adalie.me/*, so deployments retain the routing configuration. These routes serve the entire site through the Worker while preserving the existing proxied DNS records. Other subdomains, including the books API, keep their existing routing. The old CNAME file does not configure Workers routes. The direct Worker URL is https://adalie-website.dacubeking.workers.dev.

For Cloudflare Workers Builds connected to this repository:

• Repository: adaliea/adaliea.github.io
• Production branch: main
• Build command: npm run build:worker
• Deploy command: npx opennextjs-cloudflare deploy
• Non-production branch deploy command: npx opennextjs-cloudflare upload
• Root directory: the repository root
• Node.js version: 24

Node.js 24 supplies npm 11. The obsolete Ruby version and Gemfile manifests are removed so Cloudflare's dependency detection only installs the Node toolchain.

Production pushes deploy the Worker; other branches upload preview versions without changing production. Use the OpenNext deploy/upload commands so prerendered blog assets are populated along with the Worker bundle.

The legacy Pages project, adaliea-github-io, used the Jekyll build command. Its production and preview Git deployments should stay disabled after migrating to Workers Builds; changing the Pages build command alone cannot deploy this Workers application. Keep its existing domain associations and DNS records as the fallback origin. To return to the last Pages deployment, remove the two Worker routes in Cloudflare and from wrangler.jsonc before the next deployment.

No R2 bucket, D1 database, or Cloudflare Images subscription is required. Local fonts and original image assets are included in the deployment. public/_headers gives hashed Next.js assets immutable caching.

Content and rendering

• _posts/*.md remains the source of truth. Posts are read without modifying them and prerendered at build time. Their original case-sensitive .html URLs, heading anchors, handwritten notes, Atom feed IDs, and Giscus discussion titles are retained.
• projects.md supplies the projects page. scripts/prepare-content.mjs writes ignored build data to src/generated/ and copies original media into ignored public/assets/ and public/scratch/ directories. It does not publish source files.
• The homepage activity, reading log, and reading editors fetch the existing books API on the server for each request. Complete book markup and explicit width="320" height="480" image attributes are sent in the HTML. Covers use a stable 2:3 box with object-contain to retain their original proportions. There is no browser measurement or client fetch to populate the initial log.
• Client components handle search, filters, image-error fallbacks, template storage, and editor forms. The log has a retry button for upstream failures; the homepage remains readable if its activity API is unavailable. Upstream requests time out after 12 seconds. Prerendered pages use OpenNext’s read-only static-assets cache; book requests do not use an ISR cache.
• OpenNext cache interception stays disabled so Next.js handles segment-prefetch responses correctly. With the current adapter and Next.js 16, enabling that shortcut returns full-page data for segment requests and can cause an endless prefetch loop. The read-only static-assets cache remains enabled; only the shortcut around Next’s request handler is disabled.
• The existing API endpoints handle reading edits. No credentials or changes to that backend are introduced.
• next.config.ts redirects legacy page .html aliases and the resume, LinkedIn, and YouTube shortcuts. Blog URLs remain unchanged.
• Existing Jekyll templates and styles are retained as historical references; they are no longer part of the build. Ruby and Bundler are not required.

The optional server-only BOOKS_API_URL environment variable overrides the public API for local tests. Production defaults to https://books.api.dacubeking.com. Tests use a local fixture server and never submit changes to the live books API.

Checks

npm run lint
npm run typecheck
npm test
npm run build:worker
npx playwright install chromium
npm run test:e2e
npm run test:worker

Browser tests run against both the Node production build and the actual Workers runtime on desktop and mobile, covering navigation, old URLs, note cleanup, template persistence, API failure/retry, editor parameters, and book content with JavaScript disabled. Set PLAYWRIGHT_CHROMIUM_EXECUTABLE to use an existing Chrome installation. CI runs these checks without publishing the site.

Biome handles linting and formatting (npm run format), including TypeScript 7 syntax. The sharp override pins the patched compatible release used by Wrangler/Miniflare; retain it until the upstream dependency is updated.