Skip to main content

Community

BubuStack is built in the open. We're a small project with big ambitions, and we need contributors who want to build something meaningful.

Where to find us

  • GitHubbubustack organization. Code, issues, discussions, and examples all live here.
  • DiscordJoin our server for real-time chat, questions, and collaboration.

How to contribute

  1. Pick something — Browse open issues or check the Roadmap for what needs help.
  2. Fork & branch — Work from a feature branch. Keep commits scoped.
  3. Test — Add unit and integration tests. Use KinD for operator/transport changes.
  4. PR — Reference the issue, include context. Reviews target 2 business days.

Contribution areas

  • Operator — Controllers, webhooks, CRDs, reconciliation logic.
  • Transports — Bobravoz gRPC and new transport implementations.
  • SDK — Go SDK, testing harnesses, new language SDKs.
  • Engrams & Impulses — New reusable components for the catalog.
  • Docs & examples — Tutorials, guides, production runbooks.
  • Bug fixes — Triage, reproduce, fix. Always welcome.

Coding standards

  • Go: gofmt, goimports, golangci-lint.
  • TypeScript/React: repo ESLint rules.
  • YAML: deterministic, kubectl apply --server-side friendly.

Contributor ladder

We follow an open contributor ladder modeled on CNCF practices:

RoleHow you get thereWhat you gain
ContributorMerge your first PRListed in CONTRIBUTORS, community recognition
ReviewerConsistent quality contributions, domain knowledgeReview permissions, input on design decisions
MaintainerSustained contribution, trust from existing maintainersMerge rights, release authority, project direction

Early contributors shape the project. The people who show up now will have outsized influence on where BubuStack goes.

Security & responsible disclosure

Follow the project security policy in SECURITY.md. Report vulnerabilities through the GitHub Security Advisory form:

Do not report vulnerabilities in public issues.

Code of Conduct

We enforce the Code of Conduct in every repo and channel. For moderation concerns, contact: