Contributing Guidelines¶

Thank you for your interest in contributing to nicholasadamou.com!

Getting Started¶

1. Fork and Clone¶

git clone --recursive https://github.com/YOUR_USERNAME/nicholasadamou.com.git
cd nicholasadamou.com

2. Install Dependencies¶

pnpm install

3. Set Up Environment¶

cp .env.example .env.local

4. Create a Branch¶

git checkout -b feature/add-dark-mode
git checkout -b fix/navigation-bug

Development Workflow¶

pnpm dev       # Start dev server
pnpm test      # Run tests
pnpm lint      # Run linting
pnpm build     # Build check

Pull Request Process¶

Before Submitting¶

• Code follows project style guidelines
• Tests pass locally (pnpm test:run)
• Build succeeds (pnpm build)
• Documentation is updated if needed

Commit Messages¶

Follow conventional commits:

feat: add dark mode toggle
fix: resolve navigation bug on mobile
docs: update installation guide
test: add tests for theme hook

Types of Contributions¶

• Bug Fixes - Check existing issues, add reproduction test
• New Features - Open issue to discuss first
• Documentation - Located in docs/src/
• Tests - Located in src/__tests__/