Skip to content

Repository files navigation

⚡ GitCard

专为极客与开源作者打造的 100% 浏览器端高清社交预览图(Social Preview / Open Graph Image)生成器。

React TypeScript Vite Tailwind License


✨ 核心特性

  • 🎨 4 种高端极客预设模板
    • Linear Dark:紫青赛博霓虹双色光晕,深邃黑底高饱和渐变描边。
    • Mac Terminal:经典的 macOS 命令行终端风格,带交通灯控制按钮与 CLI 提示符。
    • Bento Grid:便当盒毛玻璃卡片(Apple VisionOS 质感),多卡片高斯模糊光学焦散。
    • Light Glass:纯澈珍珠白底座与高通透网格弥散光晕(Pastel Aura Gradient)。
  • 🔍 GitHub 仓库数据一键同步:输入 owner/repo 自动通过 GitHub Public API 抓取 Star、Fork、语言、License 及描述,秒级自动填单。
  • 🖥️ 纯前端浏览器渲染:无需后端服务器或 Puppeteer Headless 浏览器,零服务器成本,隐私安全。
  • 📐 1280 × 640 黄金比例:严格遵循 GitHub 官方推荐的 2:1 社交卡片尺寸规范。
  • 🚀 2x 视网膜无损导出:一键导出 2560 × 1280 超高清 PNG 图片,文字边缘锐利无锯齿。
  • 🎛️ 高自由度定制
    • 6 款强调重音色(Cyan, Indigo, Emerald, Violet, Amber, Rose);
    • 3 种背景纹理(Dot 点状网格、Radial 弥散光晕、Solid 极简纯色);
    • 模块显示自由开关(Star/Fork 统计栏、技术标签、作者头像)。

🛠️ 技术栈


🚀 本地开发快速上手

1. 克隆项目并安装依赖

git clone https://github.com/<your-username>/GitCard.git
cd GitCard
npm install

2. 启动开发服务器

npm run dev

在浏览器中打开 http://localhost:5173 即可开始使用。

3. 构建生产包

npm run build

🌐 推荐一键免费部署 (Vercel)

本项目为纯前端静态 Web 应用,非常适合部署在 VercelCloudflare PagesGitHub Pages 上:

部署到 Vercel:

  1. 将项目推送至您的 GitHub 账号;
  2. 登录 Vercel,点击 Add New Project 并选择刚刚创建的 GitCard 仓库;
  3. Framework Preset 选择 Vite(默认自动识别);
  4. 点击 Deploy,约 30 秒后即可获得全球 CDN 加速的在线访问网址!

🤝 贡献与支持

欢迎提交 Issue 和 Pull Request!如果觉得 GitCard 对你的开源项目有帮助,欢迎点一个 ⭐️ Star 支持一下!


📄 开源许可

本项目基于 MIT 许可证 开源。

About

⚡ 开源项目专属社交预览图生成器 | Aesthetic GitHub social preview card generator, 100% in-browser, 2x PNG export.

Topics

Resources

Stars

14 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages