Merge pull request #4438 from rbarbazz/local-fe-dev-improvements

fix(README): correct markdown formatting and update frontend setup with Volta

README.md

@@ -66,12 +66,12 @@ The easiest way to get started with local development is to use `docker compose
 
 Omnivore is written in TypeScript and JavaScript.
 
-- [Node](https://nodejs.org/) -- currently we are using Node.js v18.16
-- [Chromium](https://www.chromium.org/chromium-projects/) -- see below for installation info
+- [Node.js](https://nodejs.org/) (v18.16) and [Yarn](https://classic.yarnpkg.com/lang/en/) -- Versions are managed by [Volta](https://docs.volta.sh/guide/getting-started).
+- [Chromium](https://www.chromium.org/chromium-projects/) -- See below for installation info.
 
 ### Running the web and API services
 
-### 1. Start docker compose
+#### 1. Start docker compose
 
 ```bash
 git clone https://github.com/omnivore-app/omnivore
@@ -81,11 +81,11 @@ docker compose up
 
 This will start postgres, initialize the database, and start the web and api services.
 
-### 2. Open the browser
+#### 2. Open the browser
 
 Open <http://localhost:3000> and confirm Omnivore is running
 
-### 3. Login with the test account
+#### 3. Login with the test account
 
 During database setup docker compose creates an account `demo@omnivore.app`, password: `demo_password`.
 
@@ -119,25 +119,25 @@ NEXT_PUBLIC_LOCAL_SERVER_BASE_URL=http://localhost:4000
 
 To save pages you need to run the `puppeteer-parse` service.
 
-### 1. Install and configure Chromium
+#### 1. Install and configure Chromium
 
-```
+```bash
 brew install chromium --no-quarantine
 export PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true
 export CHROMIUM_PATH=`which chromium`
 ```
 
-### 2. Navigate to the service directory, setup your env file, and install dependencies
+#### 2. Navigate to the service directory, setup your env file, and install dependencies
 
-```
+```bash
 cd packages/puppeteer-parse
 cp .env.example .env
 yarn
 ```
 
-### 3. Start the service
+#### 3. Start the service
 
-```
+```bash
 yarn start
 ```
 
@@ -154,7 +154,7 @@ is done fetching your content you will see it in your library.
 Omnivore was originally designed to be deployed on GCP and takes advantage
 of some of GCP's PaaS features. We are working to make Omnivore more portable
 so you can easily run the service on your own infrastructure. You can track
-progress here: https://github.com/omnivore-app/omnivore/issues/25
+progress here: <https://github.com/omnivore-app/omnivore/issues/25>
 
 To deploy Omnivore on your own hardware you will need to deploy three
 dockerized services and configure access to a postgres service. To handle