Personal Website Template

A free, open-source portfolio website template built with Next.js, React, TypeScript, and Tailwind CSS. Fork it and make it your own in under an hour.

See it live →

Why This Template?

• Zero setup required. Fork, open in GitHub Codespaces, and start editing.
• Modern tech stack. Next.js 16, React 19, TypeScript, Tailwind CSS v4.
• Free hosting. Deploys automatically to GitHub Pages.
• Dark mode. System preference detection with manual toggle.
• Blog ready. Markdown posts with RSS feed (optional).
• AI-friendly. Works great with GitHub Copilot, Claude, and Cursor.

Get Started

Option 1: Local Development

gh repo fork mldangelo/personal-site --clone
cd personal-site
npm install
npm run dev

Requires GitHub CLI and Node.js 20+ (nvm recommended).

Option 2: GitHub Codespaces

1. Click Fork at the top of this page
2. In your fork, click Code → Codespaces → Create codespace
3. Run npm run dev

No local setup needed. Everything runs in your browser.

Customize It

Follow the adapting guide for a step-by-step checklist.

Pro tip: Open the adapting guide in Copilot Chat or your favorite AI assistant and ask it to help you customize each section.

Commands

npm run dev      # Start dev server
npm run build    # Build for production
npm run format   # Format code
npm test         # Run tests

Deploy

Push to main and GitHub Pages deploys automatically. See the adapting guide for custom domain setup.

Contributing

Contributions welcome! If you find a bug or want to improve something, please open a PR.

See contributing guide and design goals.

License

MIT. Use it however you want.