FusionAuth Quickstart: React SPA

This repository contains:

• a locally-hosted FusionAuth authorization server that runs in a container group
• frontend React code for each step of the quickstart

For full instructions, see the FusionAuth React Quickstart.

Dependencies

• Node.js v22+
• Docker v23+
• On macOS and Windows, one of the following container management tools:
  • OrbStack (run docker context use orbstack after installation to use Orbstack for docker compose commands)
  • Podman (in the commands below, replace docker with podman)
  • Docker desktop

Install and Start FusionAuth

To install and run FusionAuth locally:

1. Navigate to the fusionauth-backend directory.
2. Run the following Docker compose command:

   docker compose up -d

3. Once the compose process completes, you should see the fusionauth-backend container group in your container management tool. This group contains containers called fusionauth, db, and search. To access FusionAuth, visit http://localhost:9011/admin.
4. You can access your FusionAuth admin dashboard with the username admin@example.com and the password password.

Set Up the React App

To run any step of the quickstart:

1. Navigate into the react-frontend-steps/<name-of-step> folder.
2. Run the following command to install dependencies:

   npm install

3. Run the following command to start the app:

   npm run dev

4. To use the React app, visit the URL displayed in your terminal.