🎴 GitHub Project Cards

Generate beautiful and customizable GitHub project cards for your README, portfolio or profile.

---

📌 About

GitHub Project Cards is an open source project that generates customizable SVG cards for GitHub repositories.

You can use the generated cards inside:

• GitHub READMEs
• Portfolio websites
• Profile pages
• Documentation pages
• Personal showcases

The project includes a live preview builder where users can customize their cards in real time and copy the final markdown instantly.

---

🎨 Themes

Theme	Preview
Dark
Light
GitHub
Dracula

---

🌍 Supported Locales

---

🧩 Customization

Supported Parameters

Parameter	Description
repo	GitHub repository
theme	Card theme
lang	Locale language
image	Custom image
techs	Custom technologies
showStars	Show repository stars
showForks	Show repository forks

---

🛠️ Usage

![Project Card](https://github-project-cards.vercel.app/api/project-card?repo=username/repository)

💻 Run Locally

📥 1. Clone the repository:

git clone [https://github.com/matheusconaga/github-project-cards.git](https://github.com/matheusconaga/github-project-cards.git)

---

📂 2. Enter the project folder:

cd github-project-cards

---

📦 3. Install dependencies:

npm install

or

npm i

---

▶️ 4. Run the project:

npm run dev

---

🚀 Deploy

Deploy your own version easily on Vercel.

👥 Users

People and developers using GitHub Project Cards:

Want to appear here? Open a Pull Request adding your profile image and GitHub link.

🤝 Contributing

Contributions are always welcome!

You can contribute by:

• Reporting bugs
• Suggesting new features
• Improving documentation
• Creating new themes
• Improving performance
• Refactoring code
• Opening Pull Requests

To contribute:

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to your fork
5. Open a Pull Request

Any contribution, big or small, is appreciated 💙

📄 License

This project is licensed under the MIT License.
See the LICENSE file for more details.

💙 Support

If you like this project, give it a ⭐ and share it with friends!