[Resubmission] Open-Sourcing the GRAMO Loyalty Platform (xGov Proposal 3548330853)

[gramo]

→ xGov proposal 3548330853

→ Previous discussion (very good additional info in the comments!!!)

Why a Resubmission? i) We were evaluated by a xGov committee with half of the members inactive, which made quorum impossible to reach; ii) The note from xGov Council with personal votes was never published, which limited important info for xGovs; iii) We listened the feedback of the community during the discussion of the previous proposal and decided to open-source the repository in advance. These three circumstances encourage us to submit Gramo proposal again. We are fully open to continue discussing in this thread and strongly encourage xGovs to read previous discussion because some of your questions might be already answered before.

The proposal.

GRAMO (gramo.io) is a blockchain-based loyalty and rewards platform built on Algorand, live in production since 2022. Customers at the three partner retail stores in Madrid, Spain, earn GRAMO tokens 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 GRAMO Loyalty Platform includes the following modules in the app: claim submission by uploading cash receipts, token balance management, withdrawal to self-custody wallets, deposit, merchandise redemption, checkout, and order tracking.

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 to fully open-source the entire GRAMO application codebase (backend, frontend, and Algorand integration) under MIT license. We listened the feedback of the community during the discussion of the previous proposal and decided to open-source the repository in advance at Gramo GitHub repository.

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.

• Deployment documentation: Environment configuration, setup guide, dependency management, and infrastructure requirements.

GitHub repository: GitHub - CryptoGRAMO/gramo_dashboard_public: Gramo.io dashboard public repository · GitHub

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. Opensourcing 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. As GRAMO app is now open-sourced, others can build on it.

Some metrics.

Metric	Value
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.

The team is multidisciplinary and is composed by six members building on Algorand since 2021. The accumulated professional experience of the team includes more than 20 years experience in the fields of IT engineering, IT security, IT Networking, Biomedical Scientific Research, Marketing and Online Positioning, Risk Analysis of Financial Markets, and Real State Market.

Some links to team info:

• Famous presentation of gramo.io platform by the team in Algorand Decipher 2024: 10 min video.
• Team has been interviewed in person several times by the Algorand Foundation and has established relations with other builders and several important people in the ecosystem.
• Project wallets and team addresses are publicly documented and verifiable on-chain.

We are happy to answer all your questions questions and open to feedback.

[simonb]

To start this discussion i wish to first state, that Gramo team was unlucky and was unfortunately assigned to wrong xgov comitee with their initial proposal - which in turn made it impossible for them to pass quorums (as they state at the start of their forum thread) - so they should not be penalized for having a rejected proposal track record.

Now, i’ll just copy paste what i said on the initial proposal:

An OG team building through cycles and pivoting and adopting to the industry as it changes is exactly the kind of builders we need in the eco.

Since this is OSS after aproval request i cannot comment on the code quality, but the tech stack is apprently good enough to serve real, paying customers over the years, so it’s a working product in my book. Naturally i’ll be looking at the code once opensourced, but as far as my personal support this is a clear yes.

Let me also say, that CBD/cannabis x crypto field, while it wasn’t yet majorly adopted, doesn’t mean it won’t be, same can be said for algorand and its recognition… So having an active loyalty project with opensourced repo available is great headstart for ensuring Algorand captures that market if it decided to move to crypto rails.

good luck fam!

[uhudo]

Thanks for addressing my comments during the previous submission, which is why I also support the resubmitted proposal. Best of luck!

[DragMZ]

It seems the linked gramo.io site is dead.

[gramo]

Hey, thank you for the heads up, the website is up again. Sorry for that, something happened with wordpress

[HumbleShaman]

Hey!

a quick question - im not very familiar with GRAMO but i just did a quick dig through the site, specifically with partners. It looks of the 3 listed the first one isnt launched/opened, the second one doesnt allow me to create an account, and the third shows “doesnt exist” and is a personal trainer site?

[gramo]

Hi HumbleShaman, thanks for digging in, let us address each one:

The Green Point: they are currently restructuring their website and doing some works in the physical store. The GRAMO loyalty program has been fully operational with them during their active period. We have photos of the shop with the Gramo logo on display as proof of the partnership:

El Punto 030: fully operational partner store. If you’re having trouble creating an account on their site, that’s likely a technical issue on their end unrelated to Gramo. They mostly process rewards through us via cash receipts, which is actually the most common flow: customers bring their physical receipt and claim through the GRAMO app, not through the store’s own online platform. We also have some pictures at the shop showing Gramo logo:

SG Trainers: you’re right that it’s a personal trainers firm. They also had a line of CBD products alongside their fitness business, which is what brought them into the GRAMO program. It looks like they may have discontinued that CBD product line or that is no more present in the online catalogue. The most recent contact with them they told us that they’re still selling CBD creams, however it looks that these products unfortunately disappeared from the website. You can see the web archive link showing their CBD offering to document the partnership.

Worth noting that the majority of our reward transactions come from cash receipts submitted directly through the app, so a partner’s website being partially down or restructured doesn’t reflect whether the loyalty program was actively used with them. The on-chain data is the cleanest record of actual activity, which was fully addressed in a post at previous discussion.

[gramo]

For info, this is the physical flyer that clients receive in the shop with their purchases to participate in GRAMO Loyalty Platform:

(Here the version in English and the evolution of the codes since 2022)

To be clear on the broader point: what we’re open-sourcing is the platform itself, not the CBD use case. Any retailer in any industry can fork the codebase and run their own token-based loyalty program on Algorand. The three Madrid CBD stores were our proving ground, the real value here is the infrastructure, a working app tested during the years.

[HumbleShaman]

Awesome thanks for the clarification! Best of luck this round