docs: add installation, usage and configuration guides (closes #3)

docs/configuration.md

@@ -0,0 +1,13 @@
+# Configuration Guide
+
+## Environment Variables
+
+| Variable | Description | Default |
+|---|---|---|
+| `PORT` | Port the server runs on | `8000` |
+| `DEBUG` | Enable debug mode | `false` |
+| `SECRET_KEY` | Application secret key | (required) |
+| `DATABASE_URL` | Database connection string | (required) |
+
+## Setting up .env
+Create a `.env` file in the root directory and fill in the values above.

docs/installation.md

@@ -0,0 +1,27 @@
+# Installation Guide
+
+## Prerequisites
+- Git installed on your machine
+- A server or local machine to self-host
+
+## Steps
+
+### 1. Clone the repository
+```bash
+git clone https://github.com/bos-com/BOS.git
+cd BOS
+```
+
+### 2. Configure environment
+Copy the example environment file and edit it:
+```bash
+cp .env.example .env
+```
+
+### 3. Run the application
+```bash
+# Instructions will be added as the project develops
+```
+
+## Troubleshooting
+Open an issue at https://github.com/bos-com/BOS/issues if you encounter problems.

docs/usage.md

@@ -0,0 +1,13 @@
+# Usage Guide
+
+## Starting BOS
+Once installed, BOS can be accessed via your browser at `http://localhost:8000`
+
+## Self-hosting
+BOS is designed to be self-hostable. You can deploy it on:
+- A personal VPS (e.g. DigitalOcean, Linode)
+- A local server on your network
+- A cloud provider (AWS, GCP, Azure)
+
+## Configuration
+See [configuration.md](./configuration.md) for all available options.