Endpoints
/langs/stats/streak/repos/contrib/trophies/profile/stack/icon?name=bolt&color=0d87cd&size=48Usage
Embed any widget directly in a GitHub README:







Stack endpoint
https://github.spoko.space/stack?techs=Laravel,Vue,TypeScript,Tailwind,PHP,Node.js,WordPress
Icon endpoint
UI Icons — Bare single-color SVG icons for use inline in Markdown. Sourced from Phosphor Icons (thin weight):
<img height="14" src="https://github.spoko.space/icon?name=building&color=0d87cd" align="absmiddle" /> Running SPOKO SPACE
<img height="14" src="https://github.spoko.space/icon?name=bolt&color=0d87cd" align="absmiddle" /> 15+ years experience
<img height="14" src="https://github.spoko.space/icon?name=map-pin&color=0d87cd" align="absmiddle" /> Bielsko-Biała
Basics
bolt
star
rocket
sparkles
trophy
heart
Navigation & Status
map-pin
globe
eye
link
home
Common Actions
check
x
plus
minus
download
upload
copy
trash
Information & Warnings
info
warning
bell
Organization
folder
file
list
bookmark
calendar
chart-bar
Workspace
code
terminal
database
git-branch
book
bug
Security & Control
lock
shield
key
gear
user
users
building
target
briefcase
mail
cloud
Tech Stack Icons — 50+ tech icons with official brand colors. Use in /icon?name=<tech>&color=... or via /stack?techs=<tech1>,<tech2>,...
Frameworks & Languages
Laravel
Vue
Astro
React
TypeScript
JavaScript
PHP
Node.js
Python
HTML
CSS
SCSS
Next.js
Nuxt
Svelte
Angular
Remix
Solid
Express
NestJS
FastAPI
Django
Flask
Symfony
Rails
Ruby
Go
Rust
Kotlin
Swift
.NET
CSS & UI
Tailwind
UnoCSS
Radix UI
shadcn/ui
Framer Motion
Bootstrap
MUI
Ant Design
Chakra UI
daisyUI
Databases
MySQL
PostgreSQL
MongoDB
Redis
SQLite
Prisma
Supabase
Firebase
Build & Testing
Vite
Webpack
GraphQL
Jest
Vitest
ESLint
Storybook
Figma
Turbopack
Turborepo
pnpm
Yarn
Rollup
Babel
esbuild
Playwright
Cypress
Cloud & Hosting
AWS
Azure
GCP
Vercel
Netlify
Cloudflare
Cloudflare Workers
Heroku
Railway
Render
DigitalOcean
Infrastructure
Kubernetes
Nginx
Linux
GitHub Actions
Terraform
Ansible
Grafana
Prometheus
RabbitMQ
Elasticsearch
Other
Docker
Git
WordPress
Bun
Deno
Strapi
Sanity
Hono
tRPC
Drizzle
Flutter
Dart
Electron
Tauri
WebAssembly
Solidity
MDX
Tech icons sourced from simple-icons and @iconify-icons/logos with official brand colors.
Circle variant
Add circle=1 to render the icon inside a circular badge — icon is scaled down to 75% and placed on a semi-transparent background of the same color. Control background opacity with opacity (0–1, default 0.2). Useful for profile READMEs and feature grids:
<img height="40" src="https://github.spoko.space/icon?name=rocket&color=0d87cd&size=40&circle=1" />
<img height="40" src="https://github.spoko.space/icon?name=star&color=5fe06a&size=40&circle=1&opacity=0.15" />
<img height="40" src="https://github.spoko.space/icon?name=heart&color=e05f7a&size=40&circle=1&opacity=0.35" />
Theme Params
All endpoints accept these URL query params. Hex values without the # prefix.
| Param | Type | Default | Description |
|---|---|---|---|
?theme |
str | dark |
Base palette — light or dark (default). Applies full light/dark preset; all other params override on top. |
?bg |
hex | 030620 |
Main background color |
?card |
hex | 060d24 |
Card/chip background |
?bar |
hex | 0d1a2e |
Progress bar background |
?border |
hex | 0d2a4a |
Border color |
?primary |
hex | 0d87cd |
Accent / highlight color |
?text |
hex | e5ecf6 |
Primary text color |
?muted |
hex | 7a9cc0 |
Secondary text color |
?dim |
hex | 4a6a8a |
Tertiary / dim text color |
?radius |
px | 10 |
Corner radius in pixels |
?font |
str | ui-sans-serif,system-ui,sans-serif |
Font family |
Examples
https://github.spoko.space/langs?theme=light
https://github.spoko.space/langs?bg=0d1117&primary=58a6ff&text=c9d1d9&radius=6
Fork & Deploy
Fork the repo and clone it locally
git clone https://github.com/your-username/github-stats
cd github-stats
npm install
Create a GitHub personal access token with read:user and repo scopes, then add it as a Wrangler secret
npx wrangler secret put GITHUB_TOKEN
Add a token for the cache-bust endpoint
npx wrangler secret put CACHE_BUST_TOKEN
Update OWNERS in src/index.ts with your GitHub username(s), then deploy
npx wrangler deploy