Thanks for your interest in improving TOCflow! Contributions of all kinds are welcome — code, docs, bug reports, and ideas.
- Fork this repository and clone your fork.
- Run
npm install, thennpm run startto build in watch mode. - Make your change on a feature branch (
feat/...,fix/...,docs/...). - Run the checks:
npm run lint:js,npm run lint:css,npm run build. - Open a Pull Request against
mainand fill in the template.
For the full workflow — local WordPress setup, coding standards, testing
checklist, and the release process — see
docs/DEVELOPER_SOP.md.
- Keep PRs small and focused on a single change.
- Match the existing code style (WordPress PHP standards;
@wordpress/scriptsfor JS/CSS lint + format). - Escape all output and sanitize all input in PHP.
- Don't commit the
build/directory — it's generated and git-ignored. - Be respectful. See
CODE_OF_CONDUCT.md.
Open a GitHub Issue using the Bug report template. Include your WordPress version, PHP version, active theme, and steps to reproduce.
Check the roadmap in CLAUDE.md first — some ideas are intentionally
reserved for a future Pro version. Then open a Feature request issue to
discuss before building anything large.
By contributing, you agree that your contributions will be licensed under the GPL-2.0-or-later license that covers this project.