Skip to content

My personal website - built with Next for Static-Export, and GitHub Pages.

License

Notifications You must be signed in to change notification settings

sassdavid/personal-site

Repository files navigation

Personal Website Template

Build Status License: MIT GitHub Stars GitHub Forks

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 sassdavid/personal-site --clone
cd personal-site
npm install
npm run dev

Requires GitHub CLI and Node.js 24+ (mise or nvm).

Option 2: GitHub Codespaces

  1. Click Fork at the top of this page
  2. In your fork, click CodeCodespacesCreate 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

Using mise

If you use mise for tool version management:

mise install          # Install Node.js 24 and fd
mise run ci           # Install dependencies (npm ci)
mise run build        # Build for production
mise run lint         # Run linter
mise run type-check   # Type checking
mise run format:check # Format checking
mise run test:ci      # Run tests with coverage

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.

Acknowledgments

This site is based on the excellent personal-site template by Michael D'Angelo. Thank you for creating such a great starting point!

License

MIT. Use it however you want.

About

My personal website - built with Next for Static-Export, and GitHub Pages.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Contributors 11