Linkora is an open-source SocialFi platform built on Stellar and Soroban. It combines social networking with on-chain financial primitives — creator profiles, follow graphs, posts, token tipping, community pools, and a mini app ecosystem — for creators, communities, and investors. The protocol is governed on-chain and designed to give creators direct ownership of their audience and revenue.
| Package | State |
|---|---|
packages/contracts |
✅ Core social + DeFi primitives, unit tested |
packages/sdk |
🔧 In progress — typed contract client |
apps/web |
🔧 In progress — Next.js web frontend |
apps/mobile |
🔧 In progress — Expo / React Native mobile app |
services/indexer |
🔧 In progress — off-chain event indexer |
services/dm-relay |
🔧 In progress — E2EE direct-message relay |
services/analytics-oracle |
🔧 In progress — on-chain analytics oracle |
examples/mini-apps |
✅ Example mini apps available |
┌─────────────────────────────────────────────────────────────────┐
│ Soroban Smart Contract (packages/contracts) │
│ Profiles · Posts · Tips · Pools · Governance · Moderation │
└───────────┬────────────────────────┬────────────────────────────┘
│ contract calls (XDR) │ events (Stellar RPC)
▼ ▼
┌──────────────────────┐ ┌─────────────────────────────────────┐
│ SDK (packages/sdk) │ │ Indexer (services/indexer) │
│ LinkoraClient │ │ PostgreSQL · full-text search API │
│ TransactionQueue │ └─────────────────────────────────────┘
└──────────┬───────────┘ │ REST / WebSocket
│ ▼
│ ┌────────────────────────────────────┐
└─────────────►│ Web (apps/web) · Mobile (apps/mobile) │
│ Next.js 15 · Expo / React Native │
└────────────────────────────────────┘
# 1. Clone and run the setup script (checks prerequisites, installs deps, builds contracts)
./scripts/setup.sh
# 2. Web frontend
cd apps/web && pnpm dev # http://localhost:3000
# 3. Mobile app
cd apps/mobile && pnpm start # press 'a' (Android) or 'i' (iOS)
# 4. Indexer
cd services/indexer
cp .env.example .env # fill in DATABASE_URL and SOROBAN_RPC_URL
pnpm dev
# 5. Contract tests
pnpm --filter contracts test # or: cd packages/contracts && cargo test| Document | Description |
|---|---|
| Contract API Reference | Full function reference, storage layout, and event schema |
| System Architecture | Component overview and data flows |
| Design System | UI/UX specifications and brand identity |
| Mobile UI Spec | Screen inventory, components, tokens, accessibility |
| Mobile Developer Guide | Expo setup, simulators, EAS builds |
| Indexer Design | Event indexing strategy and search API |
| Mini Apps Developer Guide | Build and submit a Linkora mini app |
| Mini Apps Bridge API | Bridge method reference |
| Security Policy | Vulnerability disclosure guidance |
See CONTRIBUTING.md for how to set up your environment, branch conventions, and the PR process.