69 lines (57 loc) · 1.98 KB

Contributing Guide

Thanks for your interest in improving Memory Game! This guide keeps contributions simple and consistent.

Ways to Contribute

Open issues (bugs, ideas, questions)
Improve UI/UX (animations, accessibility, responsiveness)
Add features (themes, grid sizes, timers, leaderboards)
Refactor/cleanup and small fixes
Docs (README, comments, examples)

Quick Start

git clone https://github.com/debugfest/memory-game.git
cd memory-game
npm install
npm run dev

Useful scripts:

npm run dev        # Start dev server (Vite + HMR)
npm run build      # Production build
npm run preview    # Preview build

Workflow

Fork the repo and create a feature branch:

git checkout -b feat/short-description
# or fix/short-description, docs/short-description

Make focused changes and commit with clear messages:
- type(scope): short summary
- Example: feat(cards): add 6x6 hard mode
Push your branch and open a Pull Request (PR).

Coding Standards

TypeScript + React 18
Prefer readable names, small components/hooks, early returns
Keep comments only for non‑obvious logic
Tailwind CSS for styling; keep class lists tidy
No unused variables/parameters (ESLint is strict)

Project Conventions

Components under src/components/
Game utils under src/utils/
Types under src/types/

PR Checklist

Runs locally: npm run dev
Lints clean: npm run lint
Type checks: npm run typecheck
No unrelated file changes
Screenshots/GIFs for UI changes (optional but helpful)
Description explains the why + what

Reporting Issues

Please include:

What happened vs. expected behavior
Steps to reproduce
Environment (OS, browser)
Screenshots/GIFs if visual

License

By contributing, you agree your contributions are licensed under the repository’s MIT license.

Thanks again for helping make Memory Game better!