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
Что это?Kolo — это Next.js-фронтенд для продукта общественных накоплений, ориентированного на WhatsApp (по мотивам Ajo, Esusu и других ротационных накопительных кружков), который планирует использовать аккаунты Stellar и смарт-контракты Soroban для прозрачных расчётов. В этом репозитории лежат публичная лендинг-страница и интерфейс дашбордов участника/администратора.
Это весь продукт или только веб-часть с дашбордами?Только веб-часть. Next.js-приложение охватывает лендинг и дашборды участника/администратора, а WhatsApp-сценарии, сервисы Stellar и оркестрация Soroban находятся в отдельных репозиториях kolo-backend и kolo-contracts.
Как запустить его локально?Установите Node.js и npm, затем склонируйте репозиторий и выполните стандартные команды запуска dev-сервера Next.js, описанные в проекте.
Нужен ли кошелёк Stellar или аккаунт в тестнете, чтобы попробовать?Нет. Вход и регистрация — демо-сценарии, а API-маршруты кошелька/транзакций — просто заглушки, так что приложение можно запустить локально, имея только Node.js и npm.
Можно ли доверять балансам и транзакциям, показанным в дашборде?Нет. Несколько экранов дашборда используют примеры данных, а в README прямо сказано, что дашборд нельзя считать свидетельством реального кошелька, баланса, платежа или подтверждённого финансового действия.
Что контракт Soroban на самом деле делает для группы накоплений?Сопутствующий Rust-контракт на Soroban моделирует ротационные и целевые группы накоплений: обрабатывает авторизацию участников, проверку взносов, порядок выплат и управление паузами, а события контракта бэкенд использует для сверки состояния в блокчейне.
Почему основной канал — WhatsApp, а не просто веб-приложение?Kolo задуман так, чтобы участники могли присоединяться и вносить взносы через привычные переписки в WhatsApp, не разбираясь в механике Stellar; веб-приложение — это в основном лендинг и слой дашбордов администратора/участника поверх.
Накопления будут храниться в XLM или USDC?Планируемый актив — USDC на Stellar, но кодовая база ещё не до конца согласована: часть платёжных сценариев бэкенда по-прежнему использует нативный XLM, тогда как контракт Soroban ожидает настроенный токен-контракт.
Работает ли контракт Soroban где-нибудь прямо сейчас?Есть деплой на Testnet, но ни одна группа накоплений не инициализирована, и полный продуктовый процесс ещё не развёрнут.
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