CONTRIBUTING.md

Contributing

Thanks for contributing to Payflow.

Before you start

• Read the root README.md
• Install dependencies in the root and frontend/
• Create a local .env from .env.example
• Run npm test
• Run cd frontend && npm run build

Branching

Use short descriptive branch names:

• fix/auth-token-format
• feat/transaction-filtering
• docs/setup-improvements

Pull requests

Please keep PRs focused and easy to review.

Before opening a PR:

• make sure tests pass
• make sure the frontend still builds
• include a short summary of the change
• describe any tradeoffs or follow-up work

Issue labels

Recommended labels for public contribution:

• good first issue
• help wanted
• backend
• frontend
• docs
• tests
• security

Good first issue shape

A good newcomer issue here should:

• touch one part of the stack
• have a clear definition of done
• avoid risky schema changes
• fit in a small PR

Maintainer expectations

• respond to questions within a day when possible
• confirm scope before large contributions land
• ask for tests when behavior changes
• keep issue descriptions concrete and reproducible