create starter application

Author: byron-okta

NOTICE

@@ -1,19 +1,45 @@
-# React/JavaScript: Security and Identity Management
+# React/JavaScript: Starter SPA Code Sample
 
-Visit the ["React/JavaScript Code Samples: App Security in Action"](https://auth0.com/developers/hub/code-samples/spa/react-javascript) section of the ["Auth0 Developer Hub"](https://auth0.com/developers/hub) to explore how you can secure React applications written in JavaScript by implementing user authentication with Auth0.
+This JavaScript code sample demonstrates how to build a Single-Page Application (SPA) using React. This React code sample builds the API server using the React Router 6 library.
 
-[![React/JavaScript Code Samples: App Security in Action](https://cdn.auth0.com/blog/hub/code-samples/spa/react-javascript.png)](https://auth0.com/developers/hub/code-samples/spa/react-javascript)
-  
-## Basic User Authentication Code Sample
+Visit the ["React/JavaScript Code Samples: SPA Security in Action"](https://developer.auth0.com/resources/code-samples/spa/react) section of the ["Auth0 Developer Resources"](https://developer.auth0.com/resources) to explore how you can secure React applications written in JavaScript by implementing endpoint protection and authorization with Auth0.
 
-This JavaScript code sample demonstrates **how to implement user authentication** in React applications using Auth0.
+[![React/JavaScript Code Samples: SPA Security in Action](https://cdn.auth0.com/blog/hub/code-samples/spa/react-javascript.png)](https://developer.auth0.com/resources/code-samples/spa/react)
 
-Visit the ["React/JavaScript Code Sample: User Authentication For Basic Apps"](https://auth0.com/developers/hub/code-samples/spa/react-javascript/basic-authentication) page for instructions on how to configure and run this code sample and how to integrate it with an API server of your choice to [create a full-stack code sample](https://auth0.com//developers/hub/code-samples/full-stack/hello-world/basic-access-control/spa).
+## Why Use Auth0?
 
-[![React/JavaScript Code Sample: User Authentication For Basic Apps](https://cdn.auth0.com/blog/hub/code-samples/spa/react-javascript/basic-authentication.png)](https://auth0.com/developers/hub/code-samples/spa/react-javascript/basic-authentication)
+Auth0 is a flexible drop-in solution to add authentication and authorization services to your applications. Your team and organization can avoid the cost, time, and risk that come with building your own solution to authenticate and authorize users. We offer tons of guidance and SDKs for you to get started and [integrate Auth0 into your stack easily](https://developer.auth0.com/resources/code-samples/full-stack).
 
+## Set Up and Run the React Project
 
+Install the project dependencies:
 
-## Why Use Auth0?
+```bash
+npm install
+```
+
+The starter React project offers a functional application that consumes data from an external API to hydrate the user interface. For simplicity and convenience, the starter project simulates the external API locally using [`json-server`](https://github.com/typicode/json-server).
+
+However, you can also integrate this starter project with any of the ["Hello World" API code samples, which are available in multiple backend frameworks and programming languages](https://github.com/orgs/auth0-developer-hub/repositories?language=&q=api+hello-world&sort=&type=public).
+
+The compatible API server runs on `http://localhost:6060` by default. As such, to connect your React application with that API server, create a `.env` file under the root project directory and populate it with the following environment variables:
+
+```bash
+REACT_APP_API_SERVER_URL=http://localhost:6060
+```
+
+Next, execute the following command to run the JSON server API:
+
+```bash
+npm run api
+```
+
+Finally, open another terminal tab and execute this command to run your React application:
+
+```bash
+npm start
+```
+
+Visit [`http://localhost:4040/`](http://localhost:4040/) to access the starter application.
 
-Auth0 is a flexible drop-in solution to add authentication and authorization services to your applications. Your team and organization can avoid the cost, time, and risk that come with building your own solution to authenticate and authorize users. We offer tons of guidance and SDKs for you to get started and [integrate Auth0 into your stack easily](https://auth0.com/developers/hub/code-samples/full-stack).
+In the starter project, all the starter React application routes are public. However, you can use Auth0 to get an ID token to hydrate the user profile information present on the `/profile` page with information from a real user. With Auth0, you can also get an access token to make a secure call to an external API to hydrate the messages present in the `/protected` and `/admin` pages.

README.md

@@ -0,0 +1,11 @@
+{
+  "api-messages-public": {
+    "text": "This is a public message."
+  },
+  "api-messages-protected": {
+    "text": "This is a protected message."
+  },
+  "api-messages-admin": {
+    "text": "This is an admin message."
+  }
+}

json-server/db.json

@@ -0,0 +1,5 @@
+{
+  "/api/messages/public": "/api-messages-public",
+  "/api/messages/protected": "/api-messages-protected",
+  "/api/messages/admin": "/api-messages-admin"
+}