diff --git a/.env.sample b/.env.sample
index 9bb34fe..0ea6527 100644
--- a/.env.sample
+++ b/.env.sample
@@ -30,3 +30,11 @@ MH_UI_BIND_ADDR=0.0.0.0:${MH_UI_BIND_ADDR_PORT}
 ################################################################################
 API_PORT=5174
 API_JSON_WEB_KEY_SET_URL=http://kc:${KC_HTTP_PORT}/realms/master/protocol/openid-connect/certs
+
+################################################################################
+# react
+################################################################################
+VITE_PORT=5173
+VITE_AUTHORITY=http://localhost:8080/realms/master
+VITE_CLIENT_ID=react
+VITE_API_BASE_URL=http://api:5174
diff --git a/README.md b/README.md
index d38d8c7..a1f1b10 100644
--- a/README.md
+++ b/README.md
@@ -9,10 +9,10 @@ Minimal, reproducible example for Keycloak + React.
 - [Why](#why)
 - [Setup](#setup)
   * [Docker Compose](#docker-compose)
-  * [React app](#react-app)
+  * [OPTIONAL: Run React app outside of Docker Compose](#optional-run-react-app-outside-of-docker-compose)
 - [Config](#config)
 - [Links](#links)
-  * [React app](#react-app-1)
+  * [React app](#react-app)
   * [Keycloak account console](#keycloak-account-console)
   * [Keycloak admin console](#keycloak-admin-console)
   * [Mailhog UI](#mailhog-ui)
@@ -44,9 +44,9 @@ So, I thought it'd be cool to make a little project that glues these tools toget
 
 ## Setup
 
-In one terminal, run the Postgres database, Keycloak server, Mailhog server, and Express API via Docker Compose.
+In one terminal, run the Postgres database, Keycloak server, Mailhog server, Express API, and React app via Docker Compose.
 
-In another terminal, run the React app.
+**OPTIONALLY**, in another terminal, you may run the React app outside of Docker Compose.
 
 ### Docker Compose
 
@@ -63,13 +63,28 @@ In another terminal, run the React app.
 
         docker compose up
 
-### React app
+1. Wait until you see a message from the Keycloak server like this: _Running the server in development mode. DO NOT use this configuration in production._
+
+1. See [links](#links) for username and password
+
+### OPTIONAL: Run React app outside of Docker Compose
+
+1. Stop the React app container
+
+        docker compose stop react
 
 1. Install [Node.js](https://nodejs.org/en)
 1. Change to `react` folder
 
         cd react
 
+1. Create file `.env.local` with contents
+
+        VITE_PORT=5173
+        VITE_AUTHORITY=http://localhost:8080/realms/master
+        VITE_CLIENT_ID=react
+        VITE_API_BASE_URL=http://localhost:5174
+
 1. Install packages
 
         npm install
@@ -82,9 +97,7 @@ In another terminal, run the React app.
 
 ## Config
 
-The Docker Compose config should work as-is. If you need to customize it, like changing what port a service runs on, then edit file `.env`
-
-The React config should work as-is as well. If you need to customize it, then edit file `react/.env`
+The Docker Compose config should work as-is. If you need to customize it, then edit file `.env`
 
 ## Links
 
diff --git a/compose.yml b/compose.yml
index 7c9c414..fce028a 100644
--- a/compose.yml
+++ b/compose.yml
@@ -29,9 +29,24 @@ services:
       - .env
 
   api:
+    depends_on:
+      - kc
     build:
       context: ./api
     ports:
       - ${API_PORT}:${API_PORT}
     env_file:
       - .env
+
+  react:
+    depends_on:
+      - kc
+      - api
+    build:
+      context: ./react
+    ports:
+      - ${VITE_PORT}:${VITE_PORT}
+    env_file:
+      - .env
+    volumes:
+      - ./react/src:/app/src:rw
diff --git a/react/.dockerignore b/react/.dockerignore
index 1fe732a..8fa5a60 100644
--- a/react/.dockerignore
+++ b/react/.dockerignore
@@ -1,3 +1,4 @@
+.env.local
 .eslintcache
 dist
 node_modules
diff --git a/react/.env b/react/.env
deleted file mode 100644
index 7e05b92..0000000
--- a/react/.env
+++ /dev/null
@@ -1,3 +0,0 @@
-VITE_AUTHORITY=http://localhost:8080/realms/master
-VITE_CLIENT_ID=react
-VITE_API_BASE_URL=http://localhost:5174
diff --git a/react/Dockerfile b/react/Dockerfile
new file mode 100644
index 0000000..d823cb6
--- /dev/null
+++ b/react/Dockerfile
@@ -0,0 +1,6 @@
+FROM node:22-bookworm
+WORKDIR /app
+COPY package.json package-lock.json ./
+RUN npm install
+COPY . .
+CMD [ "npm", "run", "dev" ]
diff --git a/react/vite.config.ts b/react/vite.config.ts
index e2b4882..2effda0 100644
--- a/react/vite.config.ts
+++ b/react/vite.config.ts
@@ -15,7 +15,8 @@ export default defineConfig(({ command, mode }) => {
     return {
       ...commonConfig,
       server: {
-        open: true,
+        open: false,
+        port: Number(env.VITE_PORT),
         strictPort: true,
         proxy: {
           '/api': {