Contributing

We welcome contributions to FirstDevJob! Here's how to get started.

Development Setup

1. Clone the repository

git clone https://github.com/your-org/firstdevjob.git
cd firstdevjob

2. Install dependencies

bun install

3. Set up environment

Copy .env.example to .env.local and fill in the values.

4. Start development servers

# Terminal 1: Next.js dev server
bun run dev

# Terminal 2: Convex dev server
bunx convex dev

Making Changes

1. Create a branch

git checkout -b feature/your-feature-name

2. Make your changes

• Follow existing code style
• Add tests for new functionality
• Update documentation if needed

3. Test your changes

bun run lint
bun run type-check
bun run test

4. Submit a PR

• Write a clear PR description
• Reference any related issues
• Wait for review

Code Style

• TypeScript for all code
• Functional components with hooks
• Tailwind for styling
• Convex for backend logic

Getting Help

• Open an issue for bugs or feature requests
• Join discussions for questions
• Check existing issues before creating new ones