personal.page

Static text-first personal site and npm package powered by markdown content.

Structure

• content/: markdown source of truth
• generated/: built manifest and generated text indexes
• dist/web/: generated static text site for Vercel
• vercel.json: redirects, rewrites, and text headers
• packages/wangenius/: CLI package

Development

1. Install dependencies: pnpm install
2. Build and preview the static text service: pnpm dev
3. Open the local site: http://localhost:3000

Useful commands:

• pnpm build:content
• pnpm dev:web
• pnpm test

Production

Build everything:

pnpm build

Start the local preview server after build:

pnpm start

The production web service is a static Vercel output in dist/web. It consumes generated/manifest.json and is deployed with the root vercel.json.

Package

Build the npm package data snapshot:

pnpm build:package

Create a tarball locally:

pnpm pack:package

After that you can test the CLI locally with:

node packages/wangenius/bin/wangenius.mjs node packages/wangenius/bin/wangenius.mjs resume node packages/wangenius/bin/wangenius.mjs project

To publish for real later, run pnpm build:content, pnpm --filter wangenius build, then publish from packages/wangenius.

Content Workflow

• Edit markdown in content/en/* or content/zh/*
• Rebuild generated resources with pnpm build:content
• Static web output and the npm package both read from the generated manifest

Editor-only files such as content/.obsidian are ignored by the build pipeline.