Contribute to Grafana
This page lists resources for developers who want to contribute to the Grafana software ecosystem or build plugins for Grafana.
General resources
These resources are useful for all developers.
Contribute code to Grafana
Developer guide: A guide to help you get started developing Grafana software, includes instructions for how to configure Grafana for development.
Contributing to documentation: A guide to help you contribute to Grafana documentation, includes links to beginner-friendly issues.
Architecture guides: These guides explain Grafana’s background architecture.
Create a pull request: A guide for new contributors about how to create your first Grafana pull request.
Report a bug with the bug report template and include steps to reproduce.
Submit a feature request to propose improvements.
Improve our docs with the documentation contribution guide.
Help with issue triage by reviewing, labeling, and clarifying open issues.
Report security vulnerabilities following our security policy.
Communicate with Grafana
Use the right place to ask questions, report problems, and propose changes.
- GitHub issues and pull requests: Use for reproducible bugs in core Grafana and maintained plugins, small and actionable feature requests, and code or docs changes via pull requests. Avoid general “how do I” questions. For security issues, follow the security policy.
- Grafana community forums: Use for questions, troubleshooting, best practices, plugin development Q&A, and early idea discussion. Forums create a searchable public knowledge base that helps others with the same problems and questions. Start here if you are unsure: Grafana community forums.
- Grafana Community Slack: Use for quick, time-sensitive chats and networking. Do not rely on Slack for long troubleshooting or decisions. Share outcomes back to a forum topic or GitHub issue/PR to keep a public record: Grafana Community Slack.
- Not sure where to start? Start with a forum topic. Maintainers and community members will redirect you if a GitHub issue or pull request is more appropriate.
Best practices and style
Our style guides outline Grafana style for frontend, backend, documentation, and more, including best practices. Please read through them before you start editing or coding!
Backend style guide explains how we want to write Go code in the future.
Documentation style guide applies to all documentation created for Grafana products.
End to end test framework provides guidance for Grafana e2e tests.
Frontend style guide provides rules and guidance on developing in React for Grafana.
Redux framework explains how Grafana handles Redux boilerplate code.
Styling Grafana expands on styling React components with Emotion.
Theming Grafana explains how to use themes and ThemeContext in Grafana code.
