Learnault (APP)

Learnault is a decentralized learn-to-earn platform built on the Stellar blockchain that democratizes access to financial literacy and digital skills while creating verifiable, portable credentials for learners worldwide.

Vision

A world where anyone, anywhere can access quality education, earn while learning, and prove their skills with verifiable blockchain credentials — all for free.

Features

• Learn & Earn: Complete educational modules and earn Stellar-based token rewards
• Verifiable Credentials: All achievements stored immutably on Stellar
• Mobile-First: Optimized for low-bandwidth environments in emerging markets
• Privacy-Preserving: Future ZK-proof integration for selective disclosure
• B2B Talent Pool: Employers can find verified talent (paid feature)

Packages

Package	Description	Tech Stack
contracts	Soroban smart contracts for credential issuance	Rust, Soroban
api	Backend API for user management and rewards	Node.js, Express, PostgreSQL
app	Mobile-first PWA frontend	React, Next.js, TypeScript, Tailwind

Architecture

┌─────────────────────────────────────────────────────────────┐
│                      PWA Frontend (React)                   │
└───────────────────────────┬─────────────────────────────────┘
                            │
┌───────────────────────────▼─────────────────────────────────┐
│                     Backend API (Node.js)                   │
└───────────────────────────┬─────────────────────────────────┘
                            │
┌───────────────────────────▼─────────────────────────────────┐
│                   Stellar Blockchain Layer                  │
│      (Horizon API • Soroban Contracts • Asset Management)   │
└─────────────────────────────────────────────────────────────┘

For detailed architecture, see ARCHITECTURE.md.

Getting Started

Prerequisites

• Node.js 20+
• pnpm 10+
• Rust (for contract development)
• Docker (optional, for local database)

Installation

# Clone the repository
git clone https://github.com/learnault/learnault-api.git
cd learnault-api

# Install dependencies
pnpm install

# Set up environment variables
cp .env.example .env

# Set up database
pnpm db:migrate
pnpm db:seed

# Run development environment
pnpm dev

For detailed database setup instructions, see Prisma Setup Guide

Development Workflow

# Run all packages in dev mode
pnpm dev

# Build all packages
pnpm build

# Run tests
pnpm test

# Lint code
pnpm lint

Documentation

• API Documentation - API endpoints and usage
• Code of Conduct - Community guidelines
• Contributing Guide - How to contribute

Contributing

We welcome contributions! Please see our Contributing Guide and Code of Conduct.

Security

Found a security vulnerability? Please see our Security Policy.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Stellar Development Foundation for their incredible blockchain technology
• All our contributors and community members

Contact

• Discord: Join our community
• Email: learnault@toneflix.net