Operations and usage guide

This guide covers the daily workflow for maintaining the website: local development, blog updates, project edits, deployment checks, and Git commits after major updates.

Local development

Install dependencies and start the development server:

npm install
npm run dev

Default URLs:

http://127.0.0.1:3000/en
http://127.0.0.1:3000/zh

If port 3000 is already in use, run:

npm run dev -- --hostname 127.0.0.1 --port 3001

Updating blog posts

English posts live in:

src/content/blog/en/

Chinese posts live in:

src/content/blog/zh/

Each article uses Markdown frontmatter:

title: "Article title"
description: "SEO and card summary"
date: "2026-06-12"
tags: ["ROS2", "Documentation"]

Before publishing, run:

npm run lint
npm run build

Updating projects and products

Projects, shop products, personal links, and the technology stack are managed in:

src/lib/data.ts

To feature a project on the homepage, set featured to true. Project screenshots live in public/projects/ and are referenced through the screenshot field.

Deployment checklist

Before deployment, set the real domain:

NEXT_PUBLIC_SITE_URL: "https://your-domain.com"

Check these routes after deployment:

• /en and /zh
• /en/blog and /zh/blog
• /sitemap.xml
• /rss.xml
• /robots.txt

Git commits

Commit after every major update:

git add .
git commit -m "Update documentation"

This repository is already configured with:

git config --global user.name "Yu Ge"
git config --global user.email "liuzi9240@gmail.com"

For the full maintenance manual, see docs/operations-and-usage.md.