Choose Your Path
Not sure where to start? Pick the path that matches your goal.
I Want to...
Build a Frontend App (Most Common)
Use the SDK - High-level TypeScript SDK with React hooks.
- Best for: Web apps, dashboards, social platforms
- Abstracts complexity
- React integration ready
- Start here: SDK Quick Start
Query Data Only (No Writes)
Use GraphQL API - Read-only queries for the knowledge graph.
- Best for: Analytics, dashboards, data visualization
- No wallet needed for reads
- Powerful filtering and aggregation
- Start here: GraphQL Setup
Build Smart Contract Integration
Use Protocol Package - Low-level contract interactions.
- Best for: Other smart contracts, custom logic, gas optimization
- Direct contract calls
- Full control
- Start here: Protocol Configuration
Understand the System First
Read Concepts - Learn how Intuition works.
- Atoms, Triples, Signals
- Economics and incentives
- Architecture
- Start here: Primitives Overview
Learn Through a Guided Course
Use Learn Intuition - Interactive Claude Code course for protocol onboarding.
- Best for: Structured onboarding, AI-assisted learning, capstone practice
- Covers atoms, triples, signals, reads, writes, and app building
- Start here: Learn Intuition
Start from a Working App
Use Templates - Fork an official starter app.
- Best for: Faster app starts, direct protocol exploration, production-style examples
- Includes agent-readable project context
- Start here: Templates
Build with an AI Agent
Install AI Skills - Give your agent canonical Intuition protocol context.
- Best for: Claude Code, Codex, Cursor, and compatible agents
- Produces canonical protocol context and unsigned transaction parameters
- Start here: AI Skills
See Complete Examples
Follow Tutorials - Build real applications step-by-step.
- Reputation system
- Curated lists
- Social attestations
- Start here: Tutorials
Decision Tree
Build a Frontend App (Most Common)
Use the SDK - High-level TypeScript SDK with React hooks.
- Best for: Web apps, dashboards, social platforms
- Abstracts complexity
- React integration ready
Query Data Only (No Writes)
Use GraphQL API - Read-only queries for the knowledge graph.
- Best for: Analytics, dashboards, data visualization
- No wallet needed for reads
- Powerful filtering and aggregation
Build Smart Contract Integration
Use Protocol Package - Low-level contract interactions.
- Best for: Other smart contracts, custom logic, gas optimization
- Direct contract calls
- Full control
Understand the System First
Read Concepts - Learn how Intuition works.
- Atoms, Triples, Signals
- Economics and incentives
- Architecture
Learn Through a Guided Course
Use Learn Intuition - Interactive course inside Claude Code.
- Best for: Structured onboarding, context engineering, capstone practice
- Covers the protocol primitives and implementation path together
- Pairs well with the official templates
Start from a Working App
Use Templates - Official starter apps with protocol calls already wired.
- Best for: Frontend developers, agent-assisted builds, app prototypes
- Basic template for direct protocol forms
- Advanced template for GraphQL reads, protocol writes, and SIWE auth
Build with an AI Agent
Install AI Skills - Canonical Intuition context for coding agents.
- Best for: Claude Code, Codex, Cursor, and compatible agents
- Helps with ABIs, bytes32 IDs, batch-only creation, value calculations, and unsigned transaction parameters
- Pair with the templates when asking an agent to extend protocol behavior
See Complete Examples
Follow Tutorials - Build real applications step-by-step.
- Reputation system
- Curated lists
- Social attestations
Comparison Table
| Goal | Tool | Complexity | Best For |
|---|---|---|---|
| Build web app | SDK | Low | Frontend developers |
| Query data | GraphQL | Low | Analytics, read-only |
| Contract integration | Protocol | High | Solidity developers |
| Learn system | Concepts | N/A | Everyone |
| Guided course | Learn Intuition | Low | New builders and AI-assisted onboarding |
| Fork a starter app | Templates | Low-Medium | App builders |
| Agent workflow | AI Skills | Medium | AI-assisted protocol development |
Still Unsure?
Join our Discord and ask the community!
Next Steps
Once you've chosen your path:
- Follow the quick start guide for your chosen tool
- Read through the Core Concepts
- Run Learn Intuition if you want guided onboarding
- Fork a Template when you are ready to build
- Install AI Skills before asking an agent to write protocol code
- Join the Community