Learn Ricochet
Learn Ricochet is a beginner-friendly guide to Ricochet, a modern postfix language for scripts, tools, apps, packages, and release workflows.
The guide starts slowly on purpose. If you have never heard of postfix notation or stack languages, begin with Start Here before Chapter 00. If you already know stack languages, skim the Start Here pages and move into the chapter sequence.
Start Here
Learning path
Beginner runway: Chapters 00 through 05 teach the toolchain, postfix reading, the stack, values, bindings, and small data. Do not rush these if Ricochet is your first stack language.
Core language: Chapters 06 through 13 teach math, strings, collections, results, control flow, OOP, testing, and debugging.
Host and app surfaces: Chapters 14 through 28 teach time, async, capabilities, files, HTTP, sockets, processes, TUI, GUI, MVC, data, auth, forms, and AI package boundaries.
Professional workflows: Chapters 29 through 38 teach packages, registries, macros, editor tooling, bytecode, release packaging, and capstone apps.
Chapters
- Chapter 00: Welcome to Ricochet
- Chapter 01: Your First Program
- Chapter 02: Running Code and Getting Feedback
- Chapter 03: How Postfix Reads
- Chapter 04: Values, Literals, and Inspection
- Chapter 05: Names, Bindings, and Small Data
- Chapter 06: Numbers, Math, and Truth
- Chapter 07: Strings, JSON, and Regex
- Chapter 08: Collections
- Chapter 09: Results and Errors
- Chapter 10: Making Decisions and Reusing Code
- Chapter 11: OOP and Dispatch
- Chapter 12: Testing, Linting, and Formatting
- Chapter 13: Introspection And Debug Basics
- Chapter 14: Date, Time, And Duration
- Chapter 15: Async And Tasks
- Chapter 16: Capabilities And Sandboxing
- Chapter 17: Files, Workspaces, Environment, Config, And Secrets
- Chapter 18: HTTP And Streams
- Chapter 19: TCP And WebSocket Sockets
- Chapter 20: Processes And PTYs
- Chapter 21: Terminal UI
- Chapter 22: Webview And Desktop GUI
- Chapter 23: MVC First App
- Chapter 24: Routes, Controllers, And Responses
- Chapter 25: Templates, Static Assets, And Uploads
- Chapter 26: Data, Active Record, And Migrations
- Chapter 27: Sessions, Forms, Auth, And Passwords
- Chapter 28: AI Capabilities And The AI Package
- Chapter 29: Packages, Imports, And Dependencies
- Chapter 30: Registries, Publish, Yank, And Mirror
- Chapter 31: Macros And Expansion
- Chapter 32: Debugger, DAP, LSP, And Editor Tools
- Chapter 33: Bytecode, Images, And Source Emission
- Chapter 34: Packaging, Release, And Updates
- Chapter 35: Capstone CLI Tool
- Chapter 36: Capstone TUI Dashboard
- Chapter 37: Capstone MVC App
- Chapter 38: Capstone Packaged GUI App
Concepts
- Concept: Application Surfaces
- Concept: Bindings vs. Stack Juggling
- Concept: Capabilities and Sandboxing
- Concept: Postfix Evaluation
- Concept: Results and Errors
- Concept: Stack Effects
How-To Guides
- How to Choose a Data Shape
- How to Install and Run Ricochet
- How to Read Diagnostics
- How to Use the Examples
Appendices
- Appendix A: Word Groups at a Glance
- Appendix B: CLI Command Catalog
- Appendix C: Capability Flags
- Appendix D: Syntax Guardrails
- Appendix E: Troubleshooting
- Appendix F: Glossary
Style note
The main path uses installed rco commands. Source-checkout and documentation-maintenance commands belong in contributor documentation unless a chapter specifically teaches them.