kolo-frontend README

The project's README from github.com/Stellar-Kolo/kolo-frontend. As one markdown file: README.md.

Kolo — Community savings, built for Stellar

A familiar way for communities to save together, with a path to transparent digital settlement on Stellar.

Kolo is a WhatsApp-first community savings product inspired by Ajo, Esusu, and other rotating savings circles. It is being built for the way groups already organize: agree on a contribution, keep each other accountable, and take turns receiving the pooled savings.

The web app is the visual home for that experience. The product direction connects the conversational interface to Stellar accounts and assets, with Soroban contracts designed to make group rules visible and consistent. This repository contains the Next.js frontend; the backend and contracts live in their own repositories.

Status: early development. The public landing page is live at kolo-frontend.vercel.app. Member dashboards, authentication, balances, and transaction views are prototypes and do not represent live financial activity.

The Kolo idea

In a savings circle, trust is built through clear agreements and shared follow-through. Kolo aims to make those agreements easier to create and easier to track, while using Stellar as the digital settlement network underneath the experience.

People coordinate in WhatsApp
            ↓
Kolo organizes members, schedules, and group activity
            ↓
Stellar provides accounts, assets, and transaction settlement
            ↓
Soroban contracts can enforce group-specific contribution and payout rules

The intended asset for savings flows is USDC on Stellar. The codebase is still aligning asset denomination and amount handling: some existing backend payment and command flows use native XLM, while the Soroban contract accepts a configured token contract. That gap must be resolved before real savings flows are enabled.

What Stellar does in the product

The contract code has a Testnet deployment, but no savings group is initialized and the complete product flow is not deployed. See the backend integration status and contract integration notes for current limitations.

Repositories

Project Responsibility
kolo-frontend Landing page and web experience for members and administrators
kolo-backend WhatsApp workflows, application data, Stellar services, and Soroban orchestration
kolo-contracts Rust Soroban savings-group contract and contract tests

What is in this repository

Several dashboard views use sample data. Login and registration are demo flows, browser group actions include local-storage prototypes, and wallet or transaction API routes are placeholders. Do not use the dashboard as evidence of a live wallet, balance, payment, or authenticated financial action.

Built with

Run locally

Requires Node.js and npm.

npm ci
npm run dev

Open http://localhost:3000.

Available checks:

npm run lint
npm run typecheck
npm test
npm run build

Project map

Contributing

For a larger change, open an issue describing the user need and the part of the product it affects. For Stellar-facing work, include the network interaction, who authorizes it, how confirmation is checked, and what users see when it is pending or fails. Never put secret keys, seed phrases, or credentials in browser code or Git.

See AGENTS.md for repository-specific guidance. This project uses Next.js 16; read the installed framework documentation in node_modules/next/dist/docs/ before changing application code.

kolo-frontend (Stellar-Kolo/kolo-frontend)

Searching Database…

132 ·GitHub
Kolo-frontend
What is this?Kolo is the Next.js frontend for a WhatsApp-first community savings product (inspired by Ajo, Esusu, and other rotating savings circles) that plans to use Stellar accounts and Soroban smart contracts for transparent settlement. This repo holds the public landing page and member/admin dashboard UI.
Is this the full product, or just the web dashboard piece?Just the web piece. The Next.js app covers the landing page and member/admin dashboards, while WhatsApp workflows, Stellar services, and Soroban orchestration live in the separate kolo-backend and kolo-contracts repositories.
How do I run it locally?Install Node.js and npm, then clone the repo and run the standard Next.js dev server commands described in the project.
Do I need a Stellar wallet or testnet account to try it?No. Login and registration are demo flows and the wallet/transaction API routes are just placeholders, so you can run the app locally with only Node.js and npm.
Can I trust the balances and transactions shown in the dashboard?No. Several dashboard views use sample data and the README is explicit that the dashboard should not be taken as evidence of any live wallet, balance, payment, or authenticated financial action.
What does the Soroban contract actually do for a savings group?A companion Rust contract on Soroban models rotational and goal-based savings groups, handling member authorization, contribution checks, payout order, and pause controls, with contract events the backend uses to reconcile on-chain state.
Why is it WhatsApp-first instead of just a web app?Kolo is designed so members can join and contribute through familiar WhatsApp conversations without needing to understand Stellar mechanics; the web app is mainly the landing page and admin/member dashboard layer on top.
Will savings be held in XLM or USDC?The intended asset is USDC on Stellar, but the codebase hasn't fully aligned this yet: some backend payment flows still use native XLM while the Soroban contract expects a configured token contract.
Is the Soroban contract live anywhere right now?It has a Testnet deployment, but no savings group has been initialized and the complete product flow is not yet deployed.
What are similar projects?clearledger, hey.xyz, stellar-trade, solana-meme-tool, Trpjan-solana-trading-toolkit, rh-swap, stellar-pathfinder, pons-copy-trading-bot
Which topics is it in?stellar, vitest, wallet, fintech, smart-contracts, community, web3, blockchain, tailwindcss, app, authentication, nextjs
Creator
Stellar-Kolo
Size
1.4 MB
Stars
132
Updated
CommitOct 09
Age
9d
Commits · 90 Days