Letter Portfolio

Personal portfolio that is built for digital creatives

Tip

You might be intrested in building blog too, Check out Dong blog theme!

Start your online resume or projects or even FAQ through fully typed markdown and settings. Check out the Demo, hosted on GitHub Pages.

Key Features

• Astro v7 + Tailwind v4
• Optimize for speed (100% lighthouse score)
• Responsive & SEO-friendly
• Built-in i18n
• CI pipeline (ESLint + Prettier + TS Typecheck + 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

Customization

1. astro.config.mjs: Astro configs
   • site: Your final, deployed URL
2. /src/content: Site config, projects, resume and faq content
3. /src/i18n: Translation used in astro templates
4. /public: Assets used in the site (logo.svg, favicon...)
5. /src/styles/global.css: Styles
6. /.github/workflows/deploy-pipeline.yml: GitHub CI/CD pipeline (You should setup env below)
   • LHCI_GITHUB_APP_TOKEN, LHCI_TOKEN: For lighthouse and GitHub integration
   • CLOUDFLARE_ACCOUNT_ID, CLOUDFLARE_API_TOKEN: For Cloudflare Wrangler CD Pipeline.
   • BASE_URL: Prefix for every link and assets in website (Useful for GitHub Pages deployment that has no custom domain)

Build

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

# 2. Deploy docker container wherever you like.
docker build -t <your-astro-image-name> .
docker run -p <local-port>:<container-port> <your-astro-image-name>

Helping out

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

License

MIT