nelsonlai.dev

Welcome to the monorepo of my personal blog! This repository houses the code for my blog, where I share my thoughts, projects, and insights. Feel free to explore and get inspired.

Features

Core Technologies

• Next.js 15 with App Router
• TypeScript with strict configuration
• Tailwind CSS for styling
• MDX for content
• Drizzle ORM
• I18n for internationalization support

UI/UX

• Radix UI for accessible UI components
• Responsive design
• Light/Dark mode
• Image zoom in blog posts
• Shiki for code syntax highlighting
• Motion for animations
• Table of contents for blog posts

Blog Features

• Comment system
• Like functionality
• Post view counter
• Blog post search
• RSS feed
• Sitemap

Performance & SEO

• Lighthouse score of nearly 100
• SEO optimized with meta tags and JSON-LD
• Dynamic open graph images using next/og

Development Experience

• Vitest for unit/integration testing
• Playwright for E2E testing
• ESLint configuration
• Prettier code formatting
• Lefthook
• Conventional commit lint
• CSpell for spell checking

Authentication & Data

• Better Auth
• Redis caching
• Upstash for API rate limiting
• t3-env for environment variables
• Umami Analytics

Getting Started

Prerequisites

• Node.js
• Bun
• Docker
• Visual Studio Code with recommended extensions
• Optionally React Developer Tools

Development

To run this project locally, you need to set up the development environment.

Setup

1. Clone the repository:

git clone https://github.com/nelsonlaidev/nelsonlai.dev

2. Navigate to the project directory:

cd nelsonlai.dev

3. Install dependencies using Bun:

bun install

Environment Setup

1. Copy .env.example to .env.local and update the environment variables as needed.

cp .env.example .env.local

2. Run required services using Docker:

docker compose up -d

3. Run the database migrations:

bun db:migrate

4. Seed the database:

bun db:seed

5. Run the app:

bun dev # Run all services
# or
bun dev:web # Run only the web app
# or
bun dev:docs # Run only the documentation app

The services will be available at the following URLs:

Service	URL
App	localhost:3000
Docs	localhost:3002
Database	localhost:5432
Redis	localhost:6379
Redis serverless	localhost:8079

Credits

This project has been made possible thanks to the wonderful open-source community. Special thanks to:

• Timothy for the Tailwind nextjs starter blog template.
• Eihab for the UI design inspiration (Figma)

This project also uses/adapts the following open-source projects:

• Comment System - from fuma-comment
• Rehype Plugins - from fumadocs
• UI components - from shadcn/ui
• ESLint config - from @antfu/eslint-config
• Admin UI - from shadcn-admin

The following projects were referenced for inspiration:

• fumadocs
• leerob.io
• nerdfish.be
• nextra.site
• theodorusclarence.com
• ped.ro
• delba.dev
• joshwcomeau.com
• blog.maximeheckel.com
• zenorocha.com
• jahir.dev
• anishde.dev
• nikolovlazar.com
• samuelkraft.com
• bentogrids.com
• ui.aceternity.com
• hover.dev
• vocs.dev

Author

• @nelsonlaidev

Donation

If you find this project helpful, consider supporting me by sponsoring the project.

License

This project is open source and available under the MIT License.

---

Made with ❤️ in Hong Kong