LearnSol

• 

  Wordmark

Inspiration

We built LearnSol after seeing how difficult it can be for developers to start building on Solana. Beginners often jump between tutorials, documentation, code snippets, and debugging tools without understanding why a transaction succeeds or fails.

We wanted to create a learning experience that teaches the mental models behind Solana—not just the syntax. The goal is to help developers move from “I copied a snippet” to “I understand what the accounts, signers, PDAs, and runtime are doing.”

## What it does

LearnSol is a free, open-source learning platform for Solana developers.

It combines:

• Structured lessons covering Solana, Rust, Anchor, and client development
• Browser-based coding challenges with executable Rust
• Runtime Lab simulations for inspecting accounts, logs, signers, and failures
• A Visual Builder for designing Solana program architecture
• AI-assisted documentation search and explanations
• A publishable agent skill that helps coding agents teach Solana

The core learning loop is simple:

Learn a concept → practice it in code → inspect the runtime → build it into a project.

## How we built it

LearnSol is built with Next.js, React, TypeScript, Tailwind CSS, Fumadocs MDX, Monaco Editor, React Flow, PostgreSQL, Drizzle, pgvector, Privy, and the AI SDK.

Our curriculum and challenges are content-first and defined in MDX, which lets us improve the learning experience without constantly changing database schemas. Rust challenges are validated through server-side execution, while project-based challenges use Solana and Anchor starter repositories with an isolated Rust build runner.

We also built persistent authentication and progress tracking so learners can return to their work across lessons, challenges, and tools.

## Challenges we ran into

The biggest challenge was making Solana’s execution model approachable. Concepts like account ownership, signer requirements, PDA derivation, transaction messages, and CPIs can feel abstract until learners can interact with them.

We also had to think carefully about safely executing user-submitted code, handling authentication and progress persistence, managing asynchronous challenge runs, and dealing with version differences across Rust, Anchor, and Solana tooling.

Designing multiple learning tools that feel like one coherent product was another challenge. Lessons, challenges, simulations, and AI assistance all needed to reinforce the same mental models.

## Accomplishments that we're proud of

We are proud that LearnSol goes beyond static documentation and creates an interactive learning loop.

Some highlights include:

• More than 100 structured lessons
• A 30-exercise Rust challenge track
• An interactive Solana Runtime Lab
• A visual Solana program builder
• Source-grounded AI documentation chat
• A Solana teaching skill for coding agents
• Project-based Solana and Anchor build challenges
• An open-source architecture designed for community contributions

## What we learned

We learned that technical education is not only a content problem—it is a feedback-loop problem. Learners need an explanation, a chance to practice, immediate feedback, and a way to connect abstract concepts to real runtime behavior.

We also learned that content architecture matters. Keeping lessons and challenges content-defined makes the platform easier to maintain and allows new learning paths to be added quickly.

Most importantly, we learned that the best way to teach Solana is to make the invisible parts visible: account state, signer checks, ownership, instructions, logs, and transaction flow.

## What's next for LearnSol

Next, we want to expand LearnSol’s project-based challenges into a complete path from fundamentals to production-ready Solana applications.

We plan to add more tracks for Anchor, tokens, DeFi, client development, and testing; expand Runtime Lab with more realistic failure scenarios; improve the isolated build runner; and make it easier for contributors to publish lessons and challenges.

We also want to deepen the connection between LearnSol and AI coding agents so developers can receive source-grounded, first-principles Solana guidance directly inside their development workflow.

Built With

• codex
• next.js
• postgresql
• rust
• typescript