Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/splittydev/spacebadgers
Fast and clean SVG badges
https://github.com/splittydev/spacebadgers
badge badge-generator badges svg svg-badge
Last synced: 2 days ago
JSON representation
Fast and clean SVG badges
- Host: GitHub
- URL: https://github.com/splittydev/spacebadgers
- Owner: SplittyDev
- License: mit
- Created: 2023-05-15T19:16:02.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-03T21:11:11.000Z (17 days ago)
- Last Synced: 2025-01-11T14:04:29.590Z (9 days ago)
- Topics: badge, badge-generator, badges, svg, svg-badge
- Language: Rust
- Homepage: https://badgers.space
- Size: 1.39 MB
- Stars: 255
- Watchers: 2
- Forks: 3
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# SpaceBadgers - Fast SVG Badges
[](https://badgers.space)
[](./LICENSE)
[](https://crates.io/crates/spacebadgers)
[](https://github.com/splittydev/spacebadgers/actions)
> Yes, badgers is an ingenious name. It contains the word badge, is similar to [badgen](https://badgen.net) (a popular badge generation service), includes the `-rs` suffix 🦀 and it's an actual word! Badgers are awesome animals. And they're also the mascot of the [University of Wisconsin-Madison](https://en.wikipedia.org/wiki/Wisconsin_Badgers). I don't know why I'm telling you this, I don't even live in the US. But hey, the more you know.
[Live instance at badgers.space](https://badgers.space)
## Project Structure
- `badgers`: Core spacebadgers library
- `badgers-utils`: Internal utilities for spacebadgers
- `badgers-cli`: CLI for generating SVG badges
- `badgers-worker`: Cloudflare worker
- `badgers-web`: Web frontend for [badgers.space](https://badgers.space)
## Service Integrations
- GitHub
- Codeberg
- crates.io
- npm
- PyPI
More integrations coming soon!
## Why SpaceBadgers?
The creation of SpaceBadgers was spurred by my experiences and challenges with existing badge generators such as shields.io and badgen.net. These platforms offer excellent services, but I found certain issues that could be improved upon. Here's why I decided to build SpaceBadgers:
**1. Performance:** Acknowledging past speed concerns with platforms like Shields.io, SpaceBadgers emphasizes high performance and reliability. Our Rust-based core library and Cloudflare worker enable swift, edge-based badge delivery. Smooth integration with third-party services is achieved via NextJS API routes on Vercel, and we continually aim to enhance speed by utilizing the `edge` runtime.
**2. Stability:** Badgen.net was created as a faster alternative to shields.io, but due to its lack of active maintenance, it often breaks, leading to broken images. SpaceBadgers is actively maintained and is committed to ensuring stability and uptime.
**3. SVG Exclusivity:** In contrast to Shields.io, which produces images, SpaceBadgers dedicates itself solely to the generation of SVGs. Recognizing the scalability and high-quality visuals of SVGs, we deemed them the ideal choice. To optimize performance, we serve SVGs in a minified form, ensuring a swift and efficient delivery of badges.
Building SpaceBadgers has been a labor of love, aiming to offer a superior, reliable, and open-source SVG badge generator for the developer community. I am excited to hear your feedback and to continue evolving this project with your help. Your suggestions, contributions, and active participation are always welcome.
## Development
Clone the repository and make sure to initialize the submodules
```bash
git submodule update --init --recursive
```
### Environment Variables
> Paste this template into `badgers-web/.env.local`
```ini
#
# Frontend Configuration
#
# Worker protocol
NEXT_PUBLIC_API_PROTO=http
# Worker host
NEXT_PUBLIC_API_HOST=127.0.0.1:8787
# Web frontend protocol
NEXT_PUBLIC_WEB_PROTO=http
# Web frontend host
NEXT_PUBLIC_WEB_HOST=127.0.0.1:3000
#
# API Tokens
#
# Required for GitHub badges
GITHUB_TOKEN=ghp_Foo1234567
# Required for crates.io badges
CRATESIO_TOKEN=cio51fdR1234567
# Required for Codeberg badges
CODEBERG_TOKEN=foobar123456789
```
### spacebadgers
Click to expand
#### Prerequisites
- cargo
#### Running tests
```bash
cargo test -p spacebadgers
```
### badgers-worker
Click to expand
#### Prerequisites
- cargo
- yarn (preferred) or npm
#### Installing dependencies
```bash
cd badgers-worker
npm install # If you're using npm
yarn # If you're using yarn
```
#### Running locally
```bash
cd badgers-worker
npm run dev # If you're using npm
yarn dev # If you're using yarn
```
#### Deploying to Cloudflare
```bash
cd badgers-worker
npm run deploy # If you're using npm
yarn deploy # If you're using yarn
```
### badgers-web
Click to expand
#### Prerequisites
- yarn (preferred) or npm
#### Installing dependencies
```bash
cd badgers-web
npm install # If you're using npm
yarn # If you're using yarn
```
#### Running locally
```bash
cd badgers-web
npm run dev # If you're using npm
yarn dev # If you're using yarn
```
## Contributors
Ross MacArthur
💻
Marcin Puc
💻
Michael Altfield
🐛 🤔
Add your contributions