Skip to content

Glauedson/github-readme-educational-badge

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎓 GitHub Readme Educational Badge

Show your current education in your GitHub profile README!
Display your university/college, course, degree type, progress percentage, and even the institution image/logo.

🌍 Now with multi-language support! Available in Portuguese and English, with more languages coming soon.

🚀 Quick Setup

  1. Copy-paste the markdown snippet below into your GitHub profile README.
  2. Replace the query parameters with your own information:

English Badge:

[![badge](https://github-readme-educational-badge.vercel.app/en/badge?name=Harvard%20University&course=Computer%20Science&degree=Master&progress=90%25&img=https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ9GQ7Ku6uEiT0B0nzcP1fqZT4XoDQiir4PRw&s)](https://github.com/Glauedson/github-readme-educational-badge)

Portuguese Badge:

[![badge](https://github-readme-educational-badge.vercel.app/pt/badge?name=Harvard%20University&course=Ciência%20da%20Computação&degree=Mestrado&progress=90%25&img=https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ9GQ7Ku6uEiT0B0nzcP1fqZT4XoDQiir4PRw&s)](https://github.com/Glauedson/github-readme-educational-badge)

Response Examples:

English:

badge

Portuguese:

badge

  1. Star the repo :)

🌍 Supported Languages

Language Code Example URL
English en /en/badge?name=...
Portuguese pt /pt/badge?name=...

Note

If no language is specified, English will be used by default. Example: /badge?name=... = /en/badge?name=...

🔑 Parameters

Parameter Description Required
name Institution name ( e.g., Harvard University )
course Course/Program ( e.g., Computer Science )
degree Degree type ( e.g., Bachelor, Master, PhD )
progress Percentage of completion ( e.g., 85 - without % symbol )
img Link to institution logo or image

📝 API Endpoints

Get Badge

GET /{language}/badge
GET /badge  # defaults to English

Query Parameters: All parameters listed in the table above.

Get API Info

GET /

Returns information about supported languages and example usage.

🌐 Contributing to Translations

We welcome contributions for new language translations! Currently supported:

  • 🇺🇸 English (en)
  • 🇧🇷 Portuguese (pt)

Want to add your language? Check out our CONTRIBUTING.md guide for detailed instructions on how to add translations.

⭐ Contribute

  • Star the repo if you like it!
  • Open an issue for bugs or feature requests.
  • Pull requests are welcome to improve the badge design or add new features.
  • Help us translate the badge to more languages! See CONTRIBUTING.md

🔧 Development

# Clone the repository
git clone https://github.com/Glauedson/github-readme-educational-badge.git

# Install dependencies
npm install

# Start development server
npm run dev

📄 License

This project is licensed under the MIT License.

📩 Contato

For any questions or suggestions, feel free to reach out:

About

A customizable GitHub profile badge that displays your university, course, and degree type. Show your academic journey directly in your README and connect with other developers who share similar paths.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors