Giter Site home page Giter Site logo

eightants / i-demoed Goto Github PK

View Code? Open in Web Editor NEW
16.0 3.0 4.0 3.27 MB

Showcase hexagon "I Demoed" stickers from physical and virtual hackathons

Home Page: https://idemoed.vercel.app

License: MIT License

TypeScript 96.03% CSS 2.58% JavaScript 1.39%
hexagon-sticker devpost typescript badges mlh hackathon-badges

i-demoed's Introduction

I Demoed

I Demoed is a hackathon badge showcase service in SVG and raster format, which can easily be included in GitHub readmes or any other webpage. The service supports badge generation from a user's Devpost activity and custom specified badges. With the prevalence of virtual hackathons, this service provides a way for the hackathon community to continue collecting the hexagon "I Demoed" stickers prominent in MLH events.

Demo

Quickstart

https://idemoed.vercel.app/api/wall?username=<USERNAME>&limit=<LIMIT>&level=<LEVEL>&events=<EVENTS>&pr=<PR>&size=<SIZE>&type=<TYPE>&placeholder=<PLACEHOLDER>

Just https://idemoed.vercel.app/api/wall?username=<USERNAME> is enough to generate a hex-tiled showcase based on a user's Devpost username. Detailed documentation on each query parameter can be found on the website.

In Markdown: ![My Wall](https://idemoed.vercel.app/api/wall?username=<USERNAME>)

In HTML: <img src="https://idemoed.vercel.app/api/wall?username=<USERNAME>"/>

Contributing

I Demoed is a community project. Improving the service by submitting badges and improving features is appreciated. Want hackers to showcase your hackathon event badge or want to add past events you participated in? Start an issue or open a pull request to expand the badge database!

Submitting Badges via Issues

Devpost Hackathons

If your hackathon is on Devpost, visit the issue page, select New issue > Submit Devpost Badge and provide the following information.

  • Badge Image: PNG image of a hexagon sticker with correct dimensions (minimum 181x209)
  • Devpost Link: Link to event on Devpost (e.g. tamuhack2020.devpost.com)

Other Hackathons/Events

If your hackathon does not use Devpost but would still like users to showcase the badge, visit the issue page, select New issue > Submit Other Badge with the following information. Badges added using this method will not be automatically matched through devpost usernames and will need to be manually specified in the events parameter.

  • Badge Image: PNG image of a hexagon sticker with correct dimensions (minimum 181x209)
  • name: Name of event
  • id: Will be used as identifier and as image name (<id>.png). A good convention is eventnameYYYY.png, for example myhackathon2020.png. id must not already exist in /public/badges/alt
  • description: Optional description of event
  • url: Optional event link

Submitting Badges via Pull Requests

  • First, make sure you're the owner of the hexagon you are submitting!
  • Fork this repo
  • Next step depends on your hackathon platform

Devpost Hackathons

Place your event badge PNG image in /public/badges/devpost with the image name as <event_name>.png corresponding to the event URL on Devpost <event_name>.devpost.com. If your event's Devpost URL is tamuhack2020.devpost.com, your badge should be named tamuhack2020.png

Other Hackathons/Events

If your hackathon does not use Devpost,

  • Place your event badge PNG image in /public/badges/alt with the image name as <id>.png. A good convention is eventnameYYYY.png, for example myhackathon2020.png.
  • Add a new metadata file named <id>.json in /public/badges/alt_meta with the template below.
{
  "name": "Event name",
  "id":
    "Will be used as identifier and as image name (<id>.png). Must not already exist in /public/badges/alt",
  "description": "Optional description of event",
  "url": "Optional event link"
}
  • id must be unique in /alt!

Make sure id only has lowercase letters, numbers and hyphens. Remove any optional fields you aren't using, and make sure the last field doesn't have a trailing comma at the end of it.

Then make a pull request to this repo. Use the devpost badge label or other badge label as necessary.

Development

  1. Clone this repository
  2. Install packages with npm i
  3. Start development server with npm run build
  4. Open pull request

i-demoed's People

Contributors

eightants avatar geooot avatar keag-dev avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

i-demoed's Issues

Feature Request: Individual badge selection

Is your proposal related to a problem?

No

Describe the solution you'd like

In the wall of stickers, make each individual clickable, opening up a modal to download/share that sticker.

Describe alternatives you've considered

n/a

Additional context

n/a

Are you willing to submit a pull request to implement this change?

Ehhh

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.