๐ Badge Categories
- ๐ All Badges
- ๐๏ธ Build
- โ Code Quality
- ๐ Repository Activity
- โญ Repository Stats
- ๐ Documentation
- ๐ Social
๐ Complete Badge Collection
All available badges for comprehensive project documentation:
๐ก Badge Groups
Badges are organized into logical groups for better presentation and maintenance:
- ๐๏ธ Build & Release: Build status, releases, and deployment badges
- โ Code Quality: Code quality metrics and analysis badges
- ๐ Repository Activity: Activity and engagement metrics
- โญ Repository Stats: Stars, forks, and popularity metrics
- ๐ Documentation: Documentation and support badges
- ๐ Social & Community: Social media and community badges
โ๏ธ Configuration
Basic Usage
import Badges from '@site/src/components/Badges';
// Default badges (uses badges.yml configuration)
<Badges />
// Custom repository
<Badges user="facebook" repository="react" />
// Specific badge groups only
<Badges groups={['build', 'quality']} />Badge Configuration (badges.yml)
# Template variables
templateVariables:
user: "The-Running-Dev"
repository: "Docusaurus-Template"
branch: "main"
# Badge groups and definitions
badgeGroups:
build:
- name: "Build Status"
url: "https://github.com/{user}/{repository}/actions"
image: "https://github.com/{user}/{repository}/workflows/CI/badge.svg"
quality:
- name: "Code Quality"
url: "https://sonarcloud.io/project/{user}_{repository}"
image: "https://sonarcloud.io/api/badges/measure?project={user}_{repository}&metric=alert_status"
# ... more badge groups๐ Supported Badge Providers
๐๏ธ CI/CD & Build
- โ GitHub Actions
- โ Travis CI
- โ CircleCI
- โ Azure DevOps
- โ Jenkins
- โ GitLab CI
๐ Quality & Analytics
- โ Codecov
- โ SonarCloud
- โ Code Climate
- โ Codacy
- โ Snyk Security
- โ LGTM
๐ฆ Package Managers
- โ NPM
- โ PyPI
- โ NuGet
- โ Maven Central
- โ Docker Hub
- โ Homebrew
๐ Social & Stats
- โ GitHub Stats (Stars, Forks)
- โ Download Counters
- โ Social Media Links
- โ Community Badges
- โ Contribution Stats
- โ Issue/PR Counters
โก System Features
๐ง Template System
- โ Variable Substitution: {user}, {repository}, {branch}
- โ Dynamic URLs: Auto-generated badge links
- โ Environment Support: Different badges per environment
- โ Custom Variables: Define your own template variables
๐จ Display Options
- โ Group Filtering: Show specific badge categories
- โ Responsive Layout: Adapts to screen size
- โ Theme Integration: Matches site theme
- โ Custom Styling: Override badge appearance
๐ก Common Use Cases
๐ฑ Project Pages
- Repository showcases
- Project documentation
- Portfolio websites
- Landing pages
๐ Documentation
- API documentation
- User guides
- Technical specs
- Status pages
๐ฏ Marketing
- Open source promotion
- Community building
- Trust indicators
- Quality signals
๐ Related Resources
Learn more about the badge system and project showcase features