From b1289d0e1bcb7267bf4d24af1b8e4ca9f84a2dfb Mon Sep 17 00:00:00 2001
From: Noah <otikanoahjunior9@gmail.com>
Date: Tue, 21 Apr 2026 12:55:21 +0300
Subject: [PATCH] docs: update README with project description and setup guide
 (closes #1)

---
 README.md | 43 +++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 41 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 2973e74..9bd9fe0 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,41 @@
-# BOS
-BOS (Bugema Operating System) the internet OS! Free, Open Source, Self hostable
+# BOS (Bugema Operating System)
+
+> The internet OS — Free, Open Source, and Self-hostable.
+
+BOS is an open-source, self-hostable operating system for the web,
+built by the Bugema Open Source Community (BOSC). It aims to provide
+a free alternative internet OS that anyone can deploy on their own server.
+
+## Features
+
+- Free and open source (MIT License)
+- Self-hostable on any server
+- Community-driven development
+- Modular and extensible architecture
+
+## Tech Stack
+
+- To be defined by the community (see Issues)
+
+## Getting Started
+
+```bash
+git clone https://github.com/bos-com/BOS.git
+cd BOS
+```
+
+## Contributing
+
+We welcome contributions! Please:
+1. Fork the repository
+2. Create a branch: `git checkout -b fix/your-feature`
+3. Make your changes and commit
+4. Open a Pull Request
+
+## License
+
+MIT License — see [LICENSE](./LICENSE) for details.
+
+## Community
+
+Built with love by the [Bugema Open Source Community](https://github.com/bos-com)
\ No newline at end of file