title: Contribution & Open Source
description: Help us improve Billing SDK - built with transparency and community collaboration
import { Callout } from 'fumadocs-ui/components/callout'
import { Cards, Card } from 'fumadocs-ui/components/card'
Billing SDK is built on the principles of open source software - transparency, collaboration, and community-driven development. We believe that great tools should be accessible to everyone and improved by collective effort.
Why Open Source?
- 🔍 Transparency - Full visibility into how components work
- 🤝 Community - Built by developers, for developers
- 🔒 Security - Open code means better security through peer review
- 📈 Innovation - Faster iteration through community contributions
- 💰 Cost-Effective - Free to use, modify, and distribute
How to Contribute
We welcome contributions from the community! Whether you're fixing bugs, adding new components, or improving documentation, your help makes Billing SDK better for everyone.
Getting Started
- Fork the repository on GitHub
- Clone your fork locally
- Create a new branch for your changes
- Make your changes following our guidelines
- Test thoroughly to ensure everything works
- Submit a pull request with a clear description
Refer our CONTRIBUTING.md for more details.
Contribution Guidelines
<Callout title="Development Setup">
Make sure you have Node.js 18+ installed and are familiar with React, TypeScript, and Tailwind CSS.
</Callout>
Adding New Components
When adding new components:
- Follow the existing component structure and naming conventions
- Include comprehensive TypeScript interfaces
- Add proper documentation with examples
- Ensure responsive design and accessibility
- Test with multiple themes
Code Style
- Use TypeScript for all components
- Follow the existing code formatting
- Use meaningful variable and function names
- Add JSDoc comments for complex functions
- Ensure components are accessible
Documentation
- Update README files as needed
- Add examples for new components
- Include prop tables and usage instructions
- Test all code examples
Types of Contributions Welcome
- 🐛 Bug Fixes - Help us fix issues and improve stability
- ✨ New Components - Add new billing and subscription components
- 📚 Documentation - Improve guides, examples, and API docs
- 🎨 Themes - Create new visual themes and variants
- 🔧 Developer Experience - Improve tooling and development workflow
- 🧪 Testing - Add tests and improve coverage
License & Usage
Billing SDK is released under the GNU General Public License (GPL), ensuring the project remains open and free:
- ✅ Use freely for any purpose
- ✅ Study and modify the source code
- ✅ Distribute copies to help others
- ✅ Distribute modified versions
- ⚠️ Must keep derivatives under GPL license
- ⚠️ Must provide source code when distributing
<Callout title="GPL License Benefits">
The GPL license ensures that Billing SDK and all derivative works remain free and open source, protecting the commons and ensuring community benefits are preserved.
</Callout>
Project Links
<Cards>
<Card
href="https://github.com/dodopayments/billingsdk"
title="GitHub Repository"
description="View source code, report issues, and contribute"
/>
<Card
href="https://github.com/dodopayments/billingsdk/issues"
title="Issue Tracker"
description="Report bugs and request features"
/>
</Cards>
Community & Support
Core Maintainers
The project is actively maintained by a team of developers at DodoPayments who are committed to keeping it up-to-date, secure, and feature-rich.
Community Support
- Issues & Bugs - Community-driven issue resolution
- Feature Requests - Prioritized based on community needs
- Documentation - Collaborative improvement of guides and examples
- Code Reviews - Peer review for quality assurance
Get Involved
- Join discussions in GitHub Issues
- Share your use cases and feedback
- Help answer questions from other users
- Suggest new features and improvements
<Callout title="Get Involved">
Whether you're a seasoned developer or just getting started, there are many ways to contribute to the project and help make it better for everyone.
</Callout>
Roadmap
Our development is guided by community feedback and industry needs:
- 🎯 Short Term - Bug fixes, performance improvements, new component variants
- 🚀 Medium Term - Advanced theming system, more component types, better accessibility
- 🌟 Long Term - Framework integrations, design system expansion, enterprise features
Join us in building the future of billing components!
Learn More
New to here? Don't worry, we welcome your questions.
If you find anything confusing, please give your feedback on GitHub Issues!
<Callout title="Questions?">
If you find anything confusing or need help getting started, please open an issue on [GitHub Issues](https://github.com/dodopayments/billingsdk/issues)!
</Callout>