Contributions are welcome. These guidelines help keep the project consistent.
- Fork the repo and clone it locally.
- Follow SETUP.md to install dependencies and configure
.env. - Create a branch for your change:
git checkout -b feature/your-featureorfix/your-fix.
- Code style: Use the project’s existing style (TypeScript, Tailwind, React). Run
pnpm lintbefore committing. - Commits: Prefer clear, short messages (e.g. “Add theme preset for streak card”, “Fix unfollow 404 handling”).
- Scope: Prefer one logical change per PR (one feature or one bugfix).
- Widgets: New card layouts, themes, or endpoints (see RECOMMENDED_CATEGORIES.md for ideas).
- Followers Check: UX, bulk actions, filters, or performance.
- Docs: Fixes or improvements to README and files in
docs/. - Bugs: Open an issue with steps to reproduce; PRs with tests or clear manual testing are appreciated.
- Update docs if you add a feature or change behavior (README or
docs/). - Ensure
pnpm buildandpnpm lintpass. - Open a PR against the default branch. Describe what changed and why.
- Maintainers will review and may request changes.
By contributing, you agree that your contributions will be licensed under the same MIT License as the project.