docs: Cleanup the README

- Replace outdated proxy explanation
- Add more explanation and links to tutorials.

Author: jstirnaman

README.md

@@ -1,4 +1,4 @@
-# Common UI for iot-api tutorials.
+# UI for iot-api tutorials
 
 This is a [Next.js](https://nextjs.org/) project bootstrapped with [`create-next-app`](https://github.com/vercel/next.js/tree/canary/packages/create-next-app) and
 customized to route `/api` requests to external middleware -
@@ -14,43 +14,34 @@ specifically, the InfluxData `iot-app-<js, python, etc.>` example applications.
    yarn dev
    ```
 
-2. Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+  By default, the server runs on port `:3000`; otherwise, the next available port (for example, `3001`).
+  Visit [http://localhost:3000](http://localhost:3000) in your browser to see the result.
 
-You can start editing the page by modifying `pages/index.tsx`. The page auto-updates as you edit the file.
+  To view the IoT Starter device dashboard, visit [http://localhost:3000/devices/](http://localhost:3000/devices/)
 
-[API routes](https://nextjs.org/docs/api-routes/introduction) can be accessed on [http://localhost:3000/api/hello](http://localhost:3000/api/hello). This endpoint can be edited in `pages/api/hello.ts`.
+1. To customize the UI default page, edit the `pages/index.tsx` file. The page auto-updates as you edit the file.
+
+Next.js provides a sample REST API at [http://localhost:3000/api/hello](http://localhost:3000/api/hello). To customize the sample endpoints, edit `pages/api/hello.ts`.
+
+View IoT Starter devices at [http://localhost:3000/devices/](http://localhost:3000/devices/).
+To customize the device pages, edit the files located in [`./pages/devices`](./pages/devices/).
 
 ## Use with `iot-api-[language]` apps
 
 To use the UI with one of the `iot-api-[language]` example apps, set `API_URL` in `./.env.development` to the URL of the API example app.
 
-`iot-api-ui` uses a Next.js _catch-all_ route and `http-proxy` to proxy all `/api` requests to your API middleware server.
-See `./pages/api/[...path].js` for the `/api` route and proxy configuration.
-
-   ```js
-   import httpProxy from 'http-proxy'
-
-   /** Set API_URL to the URL of iot-api-js, iot-api-python, etc. **/
-   const API_URL = process.env.API_URL
-   const proxy = httpProxy.createProxyServer()
-   /** Don't parse JSON bodies on the proxied route **/
-   export const config = {
-       api: {
-           bodyParser: false
-       }
-   }
-   export default (req, res) => {
-       proxy.web(req, res, { target: API_URL, changeOrigin: true })
-   }
-   ```
+The UI automatically routes all `/api/` requests to your API server.
+`iot-api-ui` uses Next.js' _catch-all_ routing and [**`rewrites`** module](https://nextjs.org/docs/pages/api-reference/next-config-js/rewrites) to act as a proxy for cross-domain requests to the server.
+To customize the URL rewrites, edit `next.config.js`.
 
 ## Learn More
 
+Follow step-by-step tutorials to build the IoT Starter app:
+
+- [InfluxDB OSS v2 Python and JavaScript tutorials](https://docs.influxdata.com/influxdb/v2/api-guide/tutorials/)
+- [InfluxDB Cloud v2 Python and JavaScript tutorials](https://docs.influxdata.com/influxdb/cloud/api-guide/tutorials/)
+
 To learn more about Next.js, see following resources:
 
 - [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
 - [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
-
-## Credits
-
-   1. https://maxschmitt.me/posts/next-js-api-proxy/ for the `http-proxy` configuration.