Contributing

Thanks for helping improve Awesome Bangladeshi FOSS.

Please review the Code of Conduct before contributing.

How to propose a project

You can contribute in two ways:

Open a Submit a New Project issue using the issue template and complete all required fields.
Or fork this repository, create a branch, add your project to the most relevant section in README.md, and open a pull request.

If you use the issue template, automation validates your submission, creates a PR, and enables auto-merge after required checks pass.

Add only genuine free and open source software/projects (OSI-approved license or equivalent).
The submitted project must have at least 10 stars.
Keep items in alphabetical order within each section (for PRs).
Use this exact format:

- [Name](link) - Short and meaningful description.

Keep descriptions concise and value-focused.
Avoid duplicate entries.
Links must point to GitHub repository URLs in this format: https://github.com/owner/repo.
Project Submission Issues must include all required information.
Repositories in removed and rejected lists are blocked from automated re-submission.
Pull requests must pass all GitHub Actions checks (lint and validate-readme).
Valid and eligible Submission Issues and non-draft pull requests are auto-merged after repository rules and required checks are satisfied.
Acceptance thresholds for automation (for example minimum stars) are managed in data/project_requirements.json.

In VS Code, the Python extension discovers the pytest suite automatically from the tests/ folder.
To enable the repository pre-commit hook in this clone, run git config core.hooksPath .githooks once.