A cute, themeable visitor counter that renders as an SVG image. It ships with several built-in themes, and you can also upload your own digit images or backgrounds to create a custom style. Just paste one link in your README or homepage!
Displayed characters support random frame selection and dynamic composition like character sprites in galgames.
Multi-layer themes split each character into independent layers — expression, eyes, mouth, face, etc. — and randomly compose them on every request. Take the lian-ren theme: with just 71 images (lass ×8 + brow ×18 + eye ×18 + mouth ×20 + face ×6), it produces 311,040 unique sprite combinations — every refresh is a brand-new pose.
Fiber v3 is built on Fasthttp, which the Fiber team describes as the fastest HTTP engine for Go. In Fiber's published TechEmpower benchmark, Fiber v3 reaches about 12.0M plaintext responses/s versus Express's 1.20M, and about 2.36M JSON responses/s versus Express's 0.95M.
For broader context, TechEmpower Round 23 compares popular frameworks using the best 15-second plaintext run on the same physical hardware:
| Framework | Plaintext RPS |
|---|---|
| ASP.NET Core | 27.53M |
| Fiber v2.52.5 prefork | 13.51M |
| Gin | 1.64M |
| Spring | 0.83M |
| Express | 0.28M |
| Laravel | 0.027M |
| Next.js | 0.002M |
Round 23 still uses Fiber v2.52.5, so treat this row as ecosystem context rather than a direct Fiber v3 measurement.
In Lolicount, that lightweight request path is paired with embedded theme assets and an embedded Nuxt SSG frontend. Counter SVGs are composed in-process, so requests avoid a separate theme fetch and respond quickly.
The root package.json uses concurrently to start both the backend (Go :9721) and the frontend (Nuxt :3721) at the same time, cross-platform compatible with macOS / Windows / Linux:
pnpm install # installs concurrently (root) and frontend deps
pnpm dev # starts both frontend and backendYou can also run them separately: pnpm dev:server (backend only) or pnpm dev:web (frontend only).
docker run -d -p 9721:9721 \
-v lolicount-data:/app/data \
ghcr.io/miaoledor/lolicount:latestOpen http://localhost:9721/@my-counter. Counter data is persisted to the SQLite file inside the lolicount-data volume.
CI/CD is powered by GitHub Actions: pushes trigger go vet + tests automatically, and pushing a v* tag builds the frontend, compiles a static binary, and pushes a Docker image to ghcr.io.
We really need your help!
Whether enriching features or adding themes, your participation is welcome.
For more contribution details, see:
| Document | Content |
|---|---|
| CONTRIBUTING.md | Contribution overview |
| docs/contributing-themes.md | Theme contribution guide |
| docs/contributing-code.md | Code contribution guide |
Like this project? If Lolicount helps you, consider buying the author a milk tea 🧋
Backend: Go 1.25+ / Fiber v3 / SQLite Performance: Fiber v3 keeps request handling fast, so counter SVGs respond quickly even under embed traffic. Frontend: Vue (Nuxt 4 SSG) / UnoCSS / GSAP Storage: request → in-memory buffer → batched writes → SQLite Deployment: single binary (embed.FS bundles themes + frontend dist) For more technical details, see the following documents:
| Document | Content |
|---|---|
| docs/architecture.md | Architecture, project structure, tech choices |
| docs/deployment.md | Usage & deployment (Win/Mac/Linux) |
| docs/projectDesign.md | Project design & interface contract |
| docs/TODOlist.md | Milestones & task status |
This project is licensed under the AGPL-3.0 license.
本项目基于 AGPL-3.0 协议开源。