r/coolgithubprojects • • 2d ago

Gami.Fied: A self-hosted gamification engine (XP, levels, badges, streaks, leaderboards) for your apps

Hey everyone,

I wanted to share a project I've been building called Gami.Fied. It is an open-source, self-hosted gamification engine that lets you add progression and reward systems to your web or mobile apps without having to build everything from scratch or send your users' data to a third-party paid service.

How it works Your app just sends basic activity events to the API (like lesson_completed or post_created), and the rules you set up in the dashboard automatically turn those events into XP, levels, streaks, achievements, or points.

What is included right now (v1.2.0)

  • Rules engine: A visual editor to set up conditions and rewards, plus a simulator so you can test your rules before making them live.

  • Progression: XP, custom levels, daily and weekly streaks (with automatic freezes), tiered badges, and multi-step challenges.

  • Points & Reward Store: Virtual currencies with expiring points and a built-in store where users can redeem rewards or coupon codes.

  • Leaderboards & Social: All-time, daily, weekly, and monthly leaderboards, weekly leagues with promotion and relegation, friend lists, and referral codes.

  • Notifications & Integrations: In-app notifications, email reminders, push notifications, webhooks, and ready-to-use connections for Discord, Slack, Stripe, and GitHub.

  • Admin Dashboard: Manage everything in one place with analytics, staging environments to test changes safely, and easy JSON export/import for your setup.

Try it out

How it was built I started this project by hand and also used Claude to help speed up development across the codebase, dashboard, docs, and tests. You can run the whole thing on your own server using Docker Compose. The main server and dashboard are licensed under AGPL-3.0, and the TypeScript and React SDKs are MIT licensed so you can safely use them inside any closed-source app.

I am actively working on this as a solo maintainer, and more updates with new features are coming soon. If you check it out, I would love to hear your feedback or any ideas on what I should build next!

P.S. The integrations, webhooks and platform admin panel are disabled for the demo site. To test them, you need to host it yourself.

5 Upvotes

4 comments sorted by

2

u/another_journey 1d ago

What a cool idea! Congrats and thanks for sharing!

1

u/Sh4d0w_0020 1d ago

Thank you! I am planning to add more features (such as mystery boxes for random rewards) and improve things here and there. Will be releasing a new version soon!

2

u/Red_cherey 1d ago

Fantastic application...I tried it out and personally found the addition of levels and XP for event achievements, much like a video game, to be an amazing experience. I highly recommend everyone give it a try.

1

u/Sh4d0w_0020 23h ago

Thank you! Glad you liked it.