Dong Blog

A battle-tested, feature-rich blog theme powered by Astro v6

Tip

Been building my blog for years — so I turned it into an open-source theme.
You might be intrested in building personal site too, Check out Letter Portfolio theme!

Key Features

Start your online posts or shortposts through fully typed markdown and settings. Check out the GitHub Pages Demo.

• Optimize for speed (100% lighthouse score)
• Responsive & SEO-friendly
• Built-in i18n
• content
  • Open Graph image generation through vercel/og with cache
  • Page search through Pagefind
  • Google Analytic
  • Beautiful code block & Mermaid diagram using expressive-code and remark-mermaid
• CI pipeline (TypeScript / Biome linter / Cypress E2E testing / Lighthouse)
• CD pipeline (Cloudflare Pages or GitHub Pages)

Getting Started

Development

# 1. Clone the repository
git clone https://github.com/riceball-tw/letter.git .

# 2. Install dependencies
pnpm install

# 3. Run development server
pnpm run dev

Build

# a. Locally
# Deploy the contents of the `./dist` folder wherever you like.
pnpm install
pnpm build
pnpm preview

# b. Build docker image
docker build -t <your-astro-image-name> .
docker run -p <local-port>:<container-port> <your-astro-image-name>

Customization

1. astro.config.mjs: Astro configs
   • site: Your final, deployed URL
2. /src/content: Site config, posts, shortposts (Markdown / MDX)
3. /src/i18n: Translations used in astro templates
4. /public: Assets used in the site (favicon, og image)
5. /src/assets: Assets used in the site (logo, logomark)
6. /src/styles/global.css: Styles
7. /.github/workflows/testing-and-deploy-pipeline.yml: GitHub CI/CD pipeline (setup .env base on .env.example)

Helping out

For questions or support, please open an issue on GitHub.

License

MIT