Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/forthebadge/for-the-badge
It all started because of an obsession with two words: “build passing”. It all ended with this: badges, for badges’ sake.
https://github.com/forthebadge/for-the-badge
Last synced: about 22 hours ago
JSON representation
It all started because of an obsession with two words: “build passing”. It all ended with this: badges, for badges’ sake.
- Host: GitHub
- URL: https://github.com/forthebadge/for-the-badge
- Owner: forthebadge
- License: gpl-3.0
- Created: 2014-08-18T20:03:24.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2024-09-13T05:31:47.000Z (3 months ago)
- Last Synced: 2024-12-05T10:03:49.579Z (8 days ago)
- Language: TypeScript
- Homepage: https://forthebadge.com
- Size: 2.27 MB
- Stars: 1,807
- Watchers: 25
- Forks: 149
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
- awesome-ccamel - forthebadge/for-the-badge - It all started because of an obsession with two words: “build passing”. It all ended with this: badges, for badges’ sake. (TypeScript)
README
## Looking to submit a badge to be hosted on our site?
To submit a badge, simply visit [our official generator](https://forthebadge.com/#/generator) create the badge and click "Submit to Approval". Once approved, it joins our collection for all to use. We allow both signed-in and non-signed-in users to submit badges for approval. Signed-in users have the added benefit of tracking the approval status of their submissions.
## For standard users
To explore our unique collection and generate badges, simply visit [our official website](https://forthebadge.com). Our site is designed to enrich your experience with an array of features and services, all dedicated to badges.
## For advanced users
We have open-sourced our badge generator so you can self-host and run our classic generator! It all started with our obsession for badges, and it ends with badges for badges' sake.
We have posted a tutorial on our youtube channel that walks through how to setup this project, [you can view it here](https://www.youtube.com/watch?v=fIKNEauzU-g)
A hosted verison of this open source generator [can be found here](https://generator.forthebadge.com)
### Running Locally
To run For the Badge on your local computer, follow these simple steps:
1. Clone the repository:
```
git clone https://github.com/forthebadge/for-the-badge.git
cd for-the-badge
```
2. Install the project dependencies using npm:
```
npm install
```
3. Start the local server using Vite:
```
npx vite
```
4. The badge generator will be available at `http://localhost:5173`. You can access it through your web browser.
5. To build the project for production:
```
npx vite build
```
### Using Docker
You can run For the Badge using Docker in two different ways. Choose the method that best suits your needs:
#### Method 1: Pull and Run the Docker Image
Use this method if you want to quickly run the latest stable version of For the Badge without building it yourself.
1. Pull the Docker image from our repository:
```
docker pull forthebadge/forthebadge
```
2. Run the Docker image:
```
docker run -p 8080:8080 forthebadge/forthebadge
```
#### Method 2: Build and Run the Docker Image Yourself
This method is ideal if you have downloaded the source code and wish to build the Docker image yourself, perhaps for development or testing purposes.
1. Build the Docker image:
```
docker build -t for-the-badge .
```
2. Run the Docker image:
```
docker run -p 8080:8080 for-the-badge
```
Regardless of the method chosen, The badge generator will be available at `http://localhost:8080`. You can access it through your web browser.
### Want to Contribute?
Contributions are welcome and keep this project going! If you'd like to contribute, please fork the repository, make your changes, and submit a pull request. Your contributions may be featured on our official site!
## License
This project is licensed under the GNU General Public License v3.0 - see the [COPYING](https://github.com/forthebadge/for-the-badge/blob/master/COPYING) file for details.