update docs

Author: alan2207

apps/nextjs-pages/README.md

@@ -0,0 +1,32 @@
+# Next.js Pages Application
+
+## Get Started
+
+Prerequisites:
+
+- Node 20+
+- Yarn 1.22+
+
+To set up the app execute the following commands.
+
+```bash
+git clone https://github.com/alan2207/bulletproof-react.git
+cd bulletproof-react
+cd apps/nextjs-pages
+cp .env.example .env
+yarn install
+```
+
+#### `yarn run-mock-server`
+
+Make sure to start the mock server before running the app.
+The mock server runs on [http://localhost:8080/api](http://localhost:8080/api).
+
+##### `yarn dev`
+
+Runs the app in the development mode.\
+Open [http://localhost:3000](http://localhost:3000) to view it in the browser.
+
+## Project Structure
+
+Since the `pages` folder isn't very flexible and doesn't allow file collocation, we are keeping the `app` folder which is our application layer where we compose all the features, and then we just re-export Next.js page specific files (the pages and `getServerSideProps`) from the `pages` folder so Next.js can pick them up and serve as pages.

apps/react-vite/README.md

@@ -0,0 +1,30 @@
+# React Vite Application
+
+## Get Started
+
+Prerequisites:
+
+- Node 20+
+- Yarn 1.22+
+
+To set up the app execute the following commands.
+
+```bash
+git clone https://github.com/alan2207/bulletproof-react.git
+cd bulletproof-react
+cd apps/react-vite
+cp .env.example .env
+yarn install
+```
+
+##### `yarn dev`
+
+Runs the app in the development mode.\
+Open [http://localhost:3000](http://localhost:3000) to view it in the browser.
+
+##### `yarn build`
+
+Builds the app for production to the `dist` folder.\
+It correctly bundles React in production mode and optimizes the build for the best performance.
+
+See the section about [deployment](https://vitejs.dev/guide/static-deploy) for more information.

docs/application-overview.md

@@ -1,12 +1,5 @@
 # 💻 Application Overview
 
-The sample application has been bootstrapped using `Vite` and its `react-ts` template. It allows us to create applications quickly without dealing with a complex tooling setup such as bundling, transpiling etc. Another reason for using Vite is simplicity, as it doesn't force us to use the meta-framework specific things, and allows us to focus on React.
-
-Other popular ways you can bootstrap the application are:
-
-- [Next.js](https://nextjs.org/)
-- [Remix](https://remix.run/)
-
 The application is relatively simple. Users can create teams where other users can join, and they start discussions on different topics between each other.
 
 A team is created during the registration if the user didn't choose to join an existing team and the user becomes the admin of it.
@@ -36,29 +29,7 @@ The application contains the following models:
 
 ## Get Started
 
-Prerequisites:
-
-- Node 20+
-- Yarn 1.22+
-
-To set up the app execute the following commands.
-
-```bash
-git clone https://github.com/alan2207/bulletproof-react.git
-cd bulletproof-react
-cd apps/react-vite
-cp .env.example .env
-yarn install
-```
-
-##### `yarn dev`
-
-Runs the app in the development mode.\
-Open [http://localhost:3000](http://localhost:3000) to view it in the browser.
-
-##### `yarn build`
-
-Builds the app for production to the `dist` folder.\
-It correctly bundles React in production mode and optimizes the build for the best performance.
+To get started, check the README.md file in the application you want to run.
 
-See the section about [deployment](https://vitejs.dev/guide/static-deploy) for more information.
+- [React Vite](../apps/react-vite/README.md)
+- [Next.js Pages](../apps/nextjs-pages/README.md)