From 164aa1deb5e1373321a5935f1397de678c94a772 Mon Sep 17 00:00:00 2001 From: Kalemeeracollins Date: Mon, 23 Mar 2026 12:47:18 +0300 Subject: [PATCH 1/3] Improve the documentation and the auth flow --- README.md | 97 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 97 insertions(+) diff --git a/README.md b/README.md index 2973e74..bd6f151 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,99 @@ # BOS BOS (Bugema Operating System) the internet OS! Free, Open Source, Self hostable + +📡 API Documentation + +This section provides an overview of available API endpoints in BOS and how to interact with them. + +🔐 Authentication + +Some endpoints may require authentication. + +Authentication is done using an API Token +The token should be included in the request headers +Format: +Authorization: Bearer + +If authentication is not required for an endpoint, it will be specified. + +📍 Endpoints +1. Get System Status + +Endpoint: /api/status +Method: GET +Authentication: Not required + +Description: +Returns the current status of the BOS system. + +Request Example: + +Method: GET +URL: /api/status + +Response Example: + +Status: Success +Data: +system: running +uptime: 24 hours +2. Get Users + +Endpoint: /api/users +Method: GET +Authentication: Required + +Description: +Retrieves a list of all users in the system. + +Request Example: + +Method: GET +URL: /api/users +Header: Authorization token required + +Response Example: + +Status: Success +Data: +user1: John +user2: Mary +3. Create User + +Endpoint: /api/users +Method: POST +Authentication: Required + +Description: +Creates a new user in the system. + +Request Example: + +Method: POST +URL: /api/users +Body: +name: John Doe +email: john@example.com + +Response Example: + +Status: Success +Message: User created successfully +4. Delete User + +Endpoint: /api/users/{id} +Method: DELETE +Authentication: Required + +Description: +Deletes a user by ID. + +Request Example: + +Method: DELETE +URL: /api/users/1 + +Response Example: + +Status: Success +Message: User deleted successfully \ No newline at end of file From 9804f74dff64ffee2660e164d9d78abd77fb37f4 Mon Sep 17 00:00:00 2001 From: 256clinton Date: Tue, 21 Apr 2026 12:49:33 +0300 Subject: [PATCH 2/3] Add setup instructions --- README.md | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) diff --git a/README.md b/README.md index bd6f151..0df054c 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,45 @@ # BOS BOS (Bugema Operating System) the internet OS! Free, Open Source, Self hostable +Setup Instructions + +Follow these steps to set up and run BOS (Bugema Operating System) locally. + +📋 Prerequisites + +Ensure you have the following installed: +Node.js (v16 or higher) +Git +npm (comes with Node.js) + +📥 Installation + +Clone the repository +git clone https://github.com/your-username/bos.git +cd bos + +Install dependencies + +npm install + +Set up environment variables + +Create a .env file in the root directory and add: + +PORT=3000 +API_TOKEN=your_secret_token + +Start the server + +npm start +✅ Verify Setup + +Open your browser or run: + +curl http://localhost:3000/api/status + +You should receive a response indicating the system is running. + 📡 API Documentation This section provides an overview of available API endpoints in BOS and how to interact with them. From f753d7616cd3eefc6c6ab4e2822c59136e4a6cc5 Mon Sep 17 00:00:00 2001 From: kalemeeracollins Date: Tue, 21 Apr 2026 13:09:18 +0300 Subject: [PATCH 3/3] Added the setup instructions --- README.md | 13 ++++--------- 1 file changed, 4 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 0df054c..1b5dd79 100644 --- a/README.md +++ b/README.md @@ -18,24 +18,19 @@ Clone the repository git clone https://github.com/your-username/bos.git cd bos -Install dependencies - + npm install -Set up environment variables - + Create a .env file in the root directory and add: - PORT=3000 API_TOKEN=your_secret_token -Start the server - + npm start ✅ Verify Setup -Open your browser or run: - + curl http://localhost:3000/api/status You should receive a response indicating the system is running.