| Branch | Purpose |
|---|---|
main |
Production-ready code. Always stable. |
dev |
Development branch. All features merge here first. |
feature/* |
New features (e.g., feature/login-page) |
fix/* |
Bug fixes (e.g., fix/navbar-bug) |
hotfix/* |
Urgent fixes for production |
git checkout dev
git pull origin dev
git checkout -b feature/your-feature-nameMake changes, commit often:
git add .
git commit -m "feat: add login form"git push origin feature/your-feature-nameThen create a PR to merge into dev (not main).
Once approved, merge to dev. Delete the feature branch.
When dev is stable and tested, create a PR from dev → main.
| Type | Format | Example |
|---|---|---|
| Feature | feature/short-description |
feature/wallet-connect |
| Bug fix | fix/short-description |
fix/header-alignment |
| Hotfix | hotfix/short-description |
hotfix/login-crash |
| Docs | docs/short-description |
docs/update-readme |
- Never push directly to
main - Always create PR for code review
- Keep commits small and descriptive
- Delete branches after merging