Open-Sourcing the GRAMO Loyalty Platform | xGov
Open-Sourcing the GRAMO Loyalty Platform
GRAMO (gramo.io) is a blockchain-based loyalty and rewards platform built on Algorand, live in production since 2022. Customers at partner retail stores earn GRAMO tokens (ASA 393498731) by uploading purchase receipts through our web app (app.gramo.io). Tokens are managed through custodial wallets with self-custody withdrawal, bridging Web2 users into the Algorand ecosystem without requiring them to understand crypto or interact with exchanges. The platform currently has ~2,000 registered users, >2,000 on-chain token holders, >7,200 verifiable on-chain rewards-related txs from rewards-distribution project wallets.
What are we proposing?
We are requesting 150,000 ALGO for the fully open-sourced GRAMO application codebase (backend, frontend, and Algorand integration) under MIT license. Code and documentation are already public at https://github.com/CryptoGRAMO/gramo_dashboard_public, as requested for the retroactive funding. The repository has been also submitted to the Open Dev Data platform of Electric Capital to comply with xGov terms and conditions.
What the Codebase contains?
The GRAMO platform is a full-stack web application with three years of production hardening, built on Django REST Framework (backend) and React (frontend):
- Django REST Framework API: RESTful backend handling user registration and JWT authentication (via djoser/simplejwt), claim submission and receipt validation, token accounting, ASA distribution via the Algorand Python SDK (algod), custodial wallet management, and partner store administration. MySQL database. Environment-based configuration via django-environ.
- React SPA frontend: Single Page Application using React Router v6 with client-side routing, context-based state management (AuthContext, GlobalContext), authentication middleware, and Axios-driven API communication. Full user flows for claim submission, token balance management, withdrawal to self-custody wallets, deposit, merchandise redemption, checkout, and order tracking. Bundled and served through Django.
- Algorand integration layer: Direct connection to Algorand node via the Python SDK for ASA transfers, wallet generation, balance tracking, and on-chain interaction — designed as a separable, reusable component that other projects can extract and adapt.
- Database schema and migrations: Complete MySQL data model for loyalty program operations including user accounts, claims, token balances, partner stores, orders, and wallet mappings.
Why this might be important for Algorand builders?
Tokenized loyalty and rewards is one of the most talked-about real-world blockchain use cases. However, there is no open-source, Algorand-native reference implementation for it. Every developer building an ASA-based rewards system starts from scratch, solving the same problems we solved years ago:
- How do you bridge physical retail purchases to on-chain token distribution?
- How do you manage custodial wallets for users who don’t know what Algorand is or don’t want to interact with crypto exchanges?
- How do you handle receipt validation, claim workflows, and token accounting at scale?
- How do you build the Algorand SDK integration in Django/Python for a production app?
GRAMO answers all of these with working, battle-tested code. Open-sourcing it means the next team building loyalty-on-Algorand doesn’t start from zero; they would fork, adapt, and ship. It also gives the Python/Django developer community a rare production-grade Algorand reference. The ecosystem is heavily JS/TS-focused. This might broaden the on-ramp to Algorand. Open-sourcing the code could also help to position Algorand for AI searches on blockchain applications in the context of Django/React projects or Loyalty Rewards.
Why now?
The Algorand Foundation’s roadmap emphasizes mainstream adoption and real-world use cases. Loyalty programs are exactly this: they connect physical businesses to on-chain activity and bring non-speculative users to Algorand. The platform is mature, stable, and ready for community use. The sooner it’s open, the sooner others can build on it.
Open-sourced Gramo Loyalty Platform:
- License: MIT
- Repository at: https://github.com/CryptoGRAMO/gramo_dashboard_public
Adoption Metrics
- Registered app users: ~2,000
- On-chain token holders: 2,007
- Total rewards-related on-chain txs: >7,200 txs
- Operational since: 2022
- Active partner stores: 3 (Spain-based CBD/cannabis retail)
- Open Program: Available to any retail store globally
About the team
Gramo team is multidisciplinary and is composed of six members building on Algorand since 2021. The accumulated professional experience of the team includes more than 20 years in IT engineering, IT security, IT Networking, Biomedical Scientific Research, Marketing and Online Positioning, Risk Analysis of Financial Markets, and Real State Market.
Additional Info
- Website: https://gramo.io
- Platform: https://app.gramo.io
- Token: ASA 393498731 - https://allo.info/asset/393498731/token
- GitHub: https://github.com/CryptoGRAMO
- Whitepaper: https://gramo.io/the-token/whitepaper/
- What is GRAMO and how it works: https://youtu.be/xNoooZ78R9g