"Whatever you do, work at it with all your heart, as working for the Lord, not for human masters." (Colossians 3:23)

Learn.tg is a gamified educational platform that makes learning engaging through crossword puzzles, with a core mission rooted in Christian principles — see our Foundational Principles (PRINCIPLES.md). Our platform at learn.tg allows students to earn cryptocurrency rewards for mastering educational content.

We believe technology should serve a higher purpose. By combining quality content with gamification and transparent cryptocurrency incentives, Learn.tg puts this mission into action:

• Making Learning Joyful: We transform education from a chore into an engaging and interactive experience.
• Rewarding Diligence: We provide tangible rewards for achievement, honoring the effort students put in.
• Building Trust: We use blockchain for a transparent and trustless reward system.
• Global Reach: We empower teachers to create and manage courses for a global audience, spreading knowledge and opportunity.

Users earn rewards for inviting others to the platform: 10% of any premium course purchase, 10% of the scholarship value for missional courses, and an extra 1 USDT when a referred pastor buys the Global Disciples course. Rewards are paid from a dedicated referral wallet — never from student scholarships. Full specification in #163 and the Architecture.

The platform consists of three main components working in unison:

1. Backend (servidor/): A Ruby on Rails application that serves as the administrative hub for managing courses, users, and content.
2. Frontend (apps/web/): A Next.js application that provides the user interface, handles user authentication via crypto wallets (SIWE), and delivers educational content. On-chain business logic is split into Web3 engines (packages/rewards, packages/gdcluster, packages/mr519) compiled to dist/ — see ARCHITECTURE.md §Web3 Engines.
3. Smart Contracts (apps/contracts/): Solidity contracts deployed on the Celo network to manage and distribute USDT rewards transparently and securely.

For a detailed technical overview, please see ARCHITECTURE.md.

git clone <repo-url>
cd learn.tg
cp apps/.env.example apps/.env
# Edit apps/.env:
#   NEXT_PUBLIC_API_URL=https://learn.tg:9001/api
#   NEXT_PUBLIC_API_BASE=https://learn.tg:3500/learntg-admin
#   NEXTAUTH_SECRET=<any-random-string>  # dev only; for production: openssl rand -base64 32
pnpm install
cd apps/web && bin/dev

Open http://localhost:4000. No database or Rails setup needed. All API requests are proxied to the live server.

Environments & wallets: for the map of production vs development sites, the wallets per role, and the difference between the frontend-only proxy mode and the full local Rails+Next.js stack, see doc/environments.md.

To set up the Rails backend and smart contracts as well, see:

• CONTRIBUTING.md
• servidor/README.md
• apps/contracts/README.md

As an AI agent, your starting point is the AGENTS.md file. Please read it.

• AI Agent Instructions (AGENTS.md)