Tutorials

Learn TopGun by building real projects. Each tutorial walks you through a complete application from start to finish.

---

Available Tutorials

Todo App

Difficulty: Beginner | Time: ~30 minutes

Build a React todo application with offline-first data and optional real-time sync. You will learn how to:

• Set up a Vite + React project with TopGun
• Use useQuery to subscribe to your todo items
• Use useQuery and useMutation React hooks
• See offline capability in action
• Observe real-time sync between browser tabs

Start the Todo App Tutorial

---

Prerequisites

Before starting any tutorial, make sure you have:

1. Node.js 18+ and pnpm installed
2. Basic familiarity with React and TypeScript
3. (Optional) The TopGun server, if you want to test real-time sync (see Quickstart for setup)