Skip to content

Commit

Permalink
Add README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
datejer committed Nov 22, 2020
1 parent ee3830b commit 9f5fa36
Showing 1 changed file with 37 additions and 0 deletions.
37 changes: 37 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
# vercel-badge

![Vercel](https://vercelbadge.vercel.app/api/datejer/vercel-badge)

Simple serverless service/utility for embedding a Vercel deployment badge in your public github repository or on your website.

## Usage

```
![Vercel](https://vercelbadge.vercel.app/api/[owner]/[repo])
```

Replace `[owner]` with the username of the repo owner, or the organization name under which the repository is located.

Replace `[repo]` with the repository name.

## Examples

These are all of the possible Vercel deployment statuses.

![Passing Demo](https://img.shields.io/badge/vercel-passing-success)
![Pending Demo](https://img.shields.io/badge/vercel-pending-yellow)
![Failed Demo](https://img.shields.io/badge/vercel-failed-critical)

## Ratelimits

This project uses the GitHub API with an OAuth app's ID and Secret to authenticate requests in order to up the ratelimit to 5k requests per hour. The publicly available deployment uses my private OAuth app credentials, so it's highly advised to deploy your own Vercel instance with your own credentials to avoid ratelimiting, especially with bigger projects.

## Deploying

[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/git/external?repository-url=https%3A%2F%2Fgithub.com%2Fdatejer%2Fvercel-badge%2Ftree%2Fmaster)

You can deploy your own Vercel instance of this project. In order to do that you must create a GitHub OAuth app and pass the Client ID and Client Secret as two environment variables. (respectively `ID` and `SECRET`)

## Contributing

Please refer to [CONTRIBUTING.md](/CONTRIBUTING.md)

1 comment on commit 9f5fa36

@vercel
Copy link

@vercel vercel bot commented on 9f5fa36 Nov 22, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please sign in to comment.