Contribute to Trustless Work
Help us build the best component library by contributing through GitHub Pull Requests.
All contributions are reviewed via GitHub
How to Contribute
Our contribution process uses GitHub to maintain quality and enable collaborative development.
1. Fork
Fork our repository on GitHub to create your own copy of the project.
2. Create
Build your component following our guidelines and add it to the appropriate directory.
3. Pull Request
Submit a Pull Request with your changes, including documentation and examples.
4. Review
Our team reviews and merges approved contributions to the main library.
Step-by-Step Guide
Follow these detailed steps to contribute your component to our library.
1Fork the Repository
Visit our GitHub repository and click the "Fork" button to create your own copy.
Fork Repository2Clone and Setup
Clone your fork locally and create a new branch for your contribution:
git clone https://github.com/YOUR_USERNAME/Trustless-Work/react-library-trustless-work-blocks
cd react-library-trustless-work-blocks
git checkout -b feature/your-component-name
npm install
3Create Your Component
Add your component to the appropriate directory structure:
src/components/your-component/
├── index.tsx # Main component
├── README.md # Documentation
├── example.tsx # Usage example
└── styles.css # Component styles
4Submit Pull Request
Push your changes and create a Pull Request with a clear description:
git add .
git commit -m "feat: add your-component-name"
git push origin feature/your-component-name
Then visit GitHub to create your Pull Request with detailed information about your component.
Contribution Guidelines
Follow Design System
Use our color palette, typography, and spacing conventions.
Accessibility First
Ensure your component meets WCAG 2.1 AA standards.
Responsive Design
Components should work seamlessly across all device sizes.
Clean Code
Write readable, well-documented TypeScript/React code.
What We're Looking For
Dashboard Components
Analytics cards, charts, data tables, and admin interfaces.
Authentication Flows
Login forms, signup pages, password reset, and social auth.
E-commerce Elements
Product cards, shopping carts, checkout flows, and pricing tables.
Marketing Sections
Hero sections, feature grids, testimonials, and call-to-action blocks.
Join Our Community
Connect with other contributors, get feedback on your designs, and collaborate on GitHub.