Get involved
Welcome to the cardano.org website. We believe that this website should be managed by a collective and not a single entity. For this to be successful, the website relies on your contributions.
cardano.org follows an incremental evolution model. This repository avoids full rebuild projects, agency-led redesigns, or "start from scratch" initiatives unless there is a demonstrated, documented and reviewed technical need. Improvements should be made through small, reviewable, continuously shipped changes.
Everyone can contribute - whether you're a developer, designer, writer, project builder, or just someone passionate about Cardano. This page will help you find the right way to get involved.
Quick Start Contributions
No Coding Required
These contributions require no technical skills - perfect for getting started:
Share Your Ideas
- Suggest new features or improvements - have an idea for the website? Share it!
- Report issues or bugs - found something broken? Let us know!
- Join discussions - participate in conversations about the website's direction
Add Your Project to the Ecosystem
- Add your application - showcase your dApp, wallet, or tool running on Cardano
- Add your company - list your organization building on Cardano
- Add your exchange - help crowdsource the exchange database
- Create an event highlight - promote your Cardano event
- Create a news article - share important ecosystem news
Adding your project is the easiest way to contribute! It takes 5-10 minutes and requires no coding experience. Just follow our step-by-step guides.
Content Contributions
Help improve the information and resources on cardano.org:
For Writers & Editors
- Fix typos and improve clarity - even small improvements matter
- Update outdated information - keep the content fresh and accurate
- Improve translations - help make content accessible in more languages
- Write tutorials - share your knowledge with the community
How to Contribute Content
- Simple edits: Click the "Edit this page" link at the bottom of any page
- Larger changes: Set up a local copy and make changes
- New pages: Follow our page creation tutorial
Before starting major content work, discuss your idea first to ensure it aligns with the website's goals.
Developer Contributions
For Developers of All Levels
Whether you want to contribute to cardano.org (this site) or developers.cardano.org (the developer portal), there are opportunities at every skill level. Both are open-source projects welcoming contributions!
Contributing to developers.cardano.org? Check out the contribution guide.
Beginner-Friendly Tasks
- Fix broken links - help maintain website quality
- Improve accessibility - make the site usable for everyone
- Add missing documentation - document undocumented features
- Fix small bugs - look for issues tagged as "good first issue"
Intermediate Tasks
- Improve existing components - enhance UI/UX of current components
- Add new features - implement requested features from discussions
- Create new components - build reusable React components
Advanced Contributions
- Architecture improvements - optimize the codebase structure
- Complex features - tackle challenging technical problems, look for issues tagged as "help wanted"
Component Development
We have a growing library of reusable components. Check out:
- Component Documentation - see all (documented) components
- AppList Component - compact app listing
- DexGrid Component - DEX showcase grid
- FAQ Component - collapsible Q&A sections
Getting Started as a Developer
- Install locally - set up your development environment
- Explore the codebase - familiarize yourself with the structure
- Pick an issue - choose from open issues
- Make your changes - follow our coding standards
- Submit a PR - use our pull request template
Design Contributions
Help improve the visual design and user experience:
- UI/UX improvements - suggest better layouts and interactions
- Design consistency - identify and fix inconsistencies
- Mobile optimization - improve the mobile experience
- Accessibility - ensure the site works for all users
- Component designs - create mockups for new components
Design contributions can be shared as mockups, Figma files, or detailed descriptions in discussions.
Data & Analytics
Help maintain accurate data across the website:
- Update transaction statistics - help maintain transaction rankings
- Verify app information - ensure listed apps are accurate and up-to-date
- Improve data quality - identify and fix data inconsistencies
- Add missing data - help fill gaps in our databases
Community Support
Help others contribute successfully:
- Answer questions - help newcomers in discussions
- Review pull requests - provide feedback on contributions
- Test changes - verify that PRs work as expected
- Write tutorials - document your contribution process
- Mentor contributors - guide others through their first contributions
What You Should Know
Before contributing, familiarize yourself with these resources:
Essential Reading
- README - project overview and setup
- CONTRIBUTING.md - contribution guidelines
- CODE_OF_CONDUCT.md - community standards
Communication Channels
- Discussions - for idea-level conversations
- Issues - for concrete plans and task management
- Cardano Discord - for real-time chat and questions
Style & Quality
- Editorial Guidelines - maintain consistency across content
- Component Docs - use existing components correctly
- Style Guide - follow writing conventions
Contribution Workflow
Every contribution follows this lifecycle:
Idea → Discussion → Issue → Implementation → PR → Review → Preview → Merge
- Idea: Start with a concept or problem to solve
- Discussion: Share and refine your idea with the community
- Issue: Create a concrete plan with clear acceptance criteria
- Implementation: Make your changes (code, content, design, etc.)
- PR: Submit a pull request using our template
- Review: Maintainers and community review your work
- Preview: Test your changes on the staging site
- Merge: Your contribution goes live!
For non-trivial changes, discussion is required before implementation. This saves time and ensures alignment with project goals.
Need Help?
- New to GitHub? Check out the GitHub Hello World guide
- New to Docusaurus? See the Docusaurus documentation
- Questions about Cardano? Visit developers.cardano.org
- General questions? Ask in Discussions
- Real-time help? Join the Cardano Discord
Recognition
All contributors are valued and recognized:
- Your name appears in the repository's contributor list
- Significant contributions may be highlighted in release notes
- Active contributors may be invited to join the maintainer team
Thank you for helping make cardano.org better for everyone!