jdgg777-portfolio
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.
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
- Click Fork at the top of this page
- In your fork, click Code → Codespaces → Create codespace
- 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.