doc: edit readme

README.md

···
 # BankingMockAPI
 
-## Getting Started
+A simple mock banking API for testing and prototyping.  
+Provides authentication, accounts, cards, and transactions endpoints backed by a seeded SQLite database.  
+Includes a React Native demo app powered by [Expo](https://expo.dev/).
+
+---
+
+## 🚀 Getting Started
 
 ### Prerequisites
 
-- [Node.js](https://nodejs.org/) (v18 or higher)
+- [Node.js](https://nodejs.org/) **v18 or higher**
 - [Docker](https://www.docker.com/) (optional, for containerized setup)
+- [Expo CLI](https://docs.expo.dev/get-started/installation/) (for running the React Native app):
+
+  ```bash
+  npm install -g expo
+  ```
+
+---
 
 ### Installation
 
-1. Clone the repository:
+```bash
+git clone [e-mail]:mokkenstorm.dev/react-native-demo
+cd react-native-demo
+```
+
+---
+
+### Running the Server
+
+#### Run directly with Node.js
 
 ```bash
-git clone <repo-url>
-cd BankingMockAPI
+cd server && npx ts-node src/server.ts
 ```
 
-2. Install dependencies:
+The server will be available at:  
+👉 `http://localhost:3001`
 
- ```bash
- npm install
- ```
+#### Run with Docker Compose
 
-### Running the Server
+```bash
+docker compose up --build
+```
 
-#### With Node.js
+Stop the service:
 
 ```bash
-node server.js
+docker compose down
 ```
 
-The server will start on [http://localhost:3001](http://localhost:3001) by default.
+Server base URL: `http://localhost:3001`
+
+---
+
+### 🎨 Running the App
 
-#### With Docker
+The repository includes a React Native demo app that connects to the API.
+
+To generate client code from the OpenAPI spec and start the app with Expo:
 
 ```bash
-docker build -t banking-mock-api .
-docker run --name banking-mock-api -d -p 3001:3001 banking-mock-api
+cd app
+npm run generate
+npm run ios
 ```
 
-Same as mentioned aboe the api will be available at on [http://localhost:3001](http://localhost:3001)
+You can replace `npm run ios` with:
+
+- `npm run android` — to run on Android
+- `npm run web` — to run in a web browser
+
+⚠️ **Note:** The app requires and **API server** (see instructions above).
+Without the server running on `http://localhost:3001`, login and data
+fetches will fail by default. If you need a different backend port/url
+and set the `SERVER_URL` environment variable before generating the
+client code, and optionally configure the `compose.yaml` for a different port.
+
+Expo will guide you through launching the app on your chosen platform.
+
+---
+
+## 📚 API Documentation
+
+Interactive documentation and the raw OpenAPI specification are exposed by the server:
+
+- **Swagger UI:**
+  [http://localhost:3001](http://localhost:3001)  
+  A browsable interface to test and explore the API endpoints.
+
+- **OpenAPI Spec (YAML):**
+  [http://localhost:3001/openapi.yaml](http://localhost:3001/openapi.yaml)  
+  The raw machine-readable specification, suitable for client generation.
+
+---
 
-Use following commands to stop or start the container:
+## 📖 API Endpoints
+
+All protected routes require a **JWT** in the `Authorization` header:
 
 ```bash
-docker container stop banking-mock-api
-docker container start banking-mock-api
+Authorization: Bearer <JWT>
 ```
 
-## API Endpoints
+### 🔑 Authentication
 
-### Authentication
+#### `POST /login`
 
-#### `POST /login`
+Authenticate and receive a token pair.
+
+**Request Body**
 
-Authenticate user and receive JWT and refresh token.
+```json
+{
+  "username": "[e-mail]",
+  "password": "password@123"
+}
+```
 
-- **Body:**
+Response 200\*\*
 
-  ```json
-  {
-    "username": "[e-mail]",
-    "password": "password@123"
-  }
-  ```
-- **Response:**
-  ```json
-  {
-    "token": "<JWT>",
-    "refreshToken": "<refresh_token>"
+```json
+{
+  "accessToken": "<JWT>",
+  "refreshToken": "<refresh_JWT>",
+  "expires": "2024-06-01T10:05:00Z"
+}
+```
+
+Response 401\*\*
+
+```json
+{
+  "errors": [],
+  "properties": {
+    "username": { "errors": ["Invalid email address"] },
+    "password": {
+      "errors": ["Too small: expected string to have >=8 characters"]
+    }
   }
-  ```
+}
+```
+
+---
 
 #### `POST /refresh-token`
 
-Get a new JWT using a refresh token.
+Exchange a refresh token for a new pair.
+
+**Request Body**
+
+```json
+{
+  "refreshToken": "<refresh_JWT>"
+}
+```
+
+Response 200\*\*
 
-- **Body:**
-  ```json
-  {
-    "refreshToken": "<refresh_token>"
-  }
-  ```
-- **Response:**
-  ```json
+```json
+{
+  "accessToken": "<new_JWT>",
+  "refreshToken": "<new_refresh_JWT>"
+}
+```
+
+---
+
+### 👤 Me
+
+#### `GET /me`
+
+Returns the authenticated user.
+
+Response 200\*\*
+
+```json
+{
+  "id": 2,
+  "username": "nmokkenstorm",
+  "fullname": "Niels Mokkenstorm",
+  "created": "2024-06-01T10:00:00Z"
+}
+```
+
+---
+
+### 🏦 Accounts
+
+#### `GET /accounts`
+
+List accounts for the authenticated user.
+
+Response 200\*\*
+
+```json
+[
   {
-    "token": "<new_JWT>",
-    "refreshToken": "<new_refresh_token>"
+    "id": 1,
+    "user_id": 1,
+    "iban": "NL00BANK0123456789",
+    "name": "Checking",
+    "balance": 1680.16
   }
-  ```
+]
+```
+
+#### `GET /accounts/{accountId}`
 
-### Accounts
+Retrieve a single account by ID.
 
-#### `GET /accounts`
+Response 200\*\*
 
-Get all accounts for the authenticated user.
+```json
+{
+  "id": 1,
+  "user_id": 1,
+  "iban": "NL00BANK0123456789",
+  "name": "Checking",
+  "balance": 1680.16
+}
+```
 
-- **Headers:**
-  - `Authorization: Bearer <JWT>`
-- **Response:**
-  ```json
-  [
-    {
-      "id": 1,
-      "user_id": 1,
-      "name": "Checking",
-      "balance": 1500.5
-    },
-    ...
-  ]
-  ```
+---
 
-### Cards
+### 💳 Cards
 
 #### `GET /cards`
 
-Get all cards for the authenticated user.
+List stored cards (**demo only**: returns full PAN and CVV).
+
+Response 200\*\*
+
+```json
+[
+  {
+    "id": 1,
+    "user_id": 1,
+    "number": "4111111111111111",
+    "expiry": "12/26",
+    "cvv": "123"
+  }
+]
+```
 
-- **Headers:**
-  - `Authorization: Bearer <JWT>`
-- **Response:**
-  ```json
-  [
-    {
-      "id": 1,
-      "user_id": 1,
-      "number": "4111111111111111",
-      "expiry": "12/26",
-      "cvv": "123"
-    },
-    ...
-  ]
-  ```
+---
 
-### Transactions
+### 🧾 Transactions
 
 #### `GET /transactions`
 
-Get transactions for the authenticated user, with search, sort, and pagination.
+Search/sort/paginate transactions. Query params: `search`, `sort` (default `date`), `order` (`asc|desc`, default `desc`), `page` (default `1`), `limit` (default `25`), `accountId`, `type`.
 
-- **Headers:**
-  - `Authorization: Bearer <JWT>`
-- **Query Parameters:**
-  - `search` (optional): Search by description or type
-  - `sort` (optional): Field to sort by (default: `date`)
-  - `order` (optional): `asc` or `desc` (default: `desc`)
-  - `page` (optional): Page number (default: `1`)
-  - `limit` (optional): Items per page (default: `10`)
-- **Response:**
-  ```json
-  [
+Response 200\*\*
+
+```json
+{
+  "data": [
     {
       "id": 1,
-      "user_id": 1,
-      "account_id": 1,
+      "userId": 1,
+      "accountId": 1,
       "amount": -50.25,
       "type": "debit",
       "description": "Grocery Store",
       "date": "2024-06-01T10:00:00Z"
-    },
-    ...
-  ]
-  ```
+    }
+  ],
+  "meta": {
+    "page": 1,
+    "limit": 25,
+    "hasMore": false,
+    "total": 1
+  }
+}
+```
+
+---
+
+#### `GET /transaction-types`
+
+Aggregate transaction types.
+
+Response 200\*\*
+
+```json
+[
+  { "name": "debit", "count": 12 },
+  { "name": "credit", "count": 5 }
+]
+```
+
+---
 
-## Default Test User
+## 👤 Default Test User
 
 - **Username:** `[e-mail]`
 - **Password:** `password@123`
 
-## Database
+---
 
-- The SQLite database is used.
-- The database is reset and seeded with test data every time the server starts.
+## 🗄️ Database
+
+- Uses **SQLite**.
+- The database is reset and seeded with test data on every server start.

app/openapi-ts.config.ts

···
 import { defineConfig } from "@hey-api/openapi-ts";
 
 export default defineConfig({
-  input: "http://localhost:3001/openapi.yaml",
+  input: process.env.SERVER_URL || "http://localhost:3001/openapi.yaml",
   output: "generated",
   plugins: [
     "@tanstack/react-query",