Introduction

These pages are the practical documentation for SnapFire FSR: what it is, how to get an application running and what the shapes are once you have. They sit beside the FSR guide, which is a different kind of document. The guide argues the design from first principles and reads front to back. This is the reference you keep open in another tab.

What you will find here

Welcome is orientation. Two pages: this one, and what FSR actually is.

Basics is everything you need to put a working application on a port: installing the tools, the shape of a project, routes and loaders, and how a page gets its data.

Advanced is the machinery you reach for once the basics hold: islands and hydration, actions and the session, and mounting one application inside another.

Patterns is the parts bin. Task-shaped answers to "I want to do X", each one a block you can lift.

Diagrams is the same material drawn rather than written, for when a picture settles a question faster than a paragraph.

What FSR assumes of you

TypeScript, and enough Rust to run cargo build. You do not need to write Rust to build an FSR application, and for a long time you will not want to. The stock host reads a configuration file and serves your application; graduating to your own Rust binary is a step you take when you need something the configuration cannot say, not a step you take on day one.

You do not need Node.js. Not to build, not to serve, not to test. That is the point of the thing, and it is worth saying plainly before you go looking for the package.json that is not there.

The lab

Read What SnapFire FSR is, then Getting started. Twenty minutes end to end, and you will have a page rendering from Rust.