First off, thanks for your interest in contributing to Spot — your support helps make local event discovery smarter and more personal.
- Fork the repository and clone it to your machine.
- Make sure you’re using Node.js v18+ and pnpm.
- Run
pnpm installto install dependencies. - Start the dev server with
pnpm dev.
- Spot uses Next.js 15 (App Router) with TypeScript and Tailwind CSS.
- Follow established patterns in
app/,components/, andlib/. - Run
pnpm lintandpnpm formatbefore submitting any changes.
Use descriptive branch names:
feature/event-filter
fix/api-timeout
refactor/card-component
- Open a new issue or join an existing discussion before starting major work.
- Create a pull request targeting the
mainbranch. - Add clear descriptions and screenshots (if applicable).
Follow the conventional format:
feat: add personalized event feed
fix: correct timezone offset in API call
- UI/UX improvements
- Integrating new event APIs
- Optimizing performance
- Writing tests
- Improving accessibility
- Localizing UI text
Thanks for helping build Spot! Let's help more people find, explore, and enjoy events around them.