diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..97a5a60
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,59 @@
+\# Contributing to BOS
+
+
+
+We welcome contributions from everyone! To keep collaboration smooth, please follow these guidelines:
+
+
+
+\## 🛠 Git Workflow
+
+\- Fork the repository
+
+\- Create a new branch for your changes
+
+\- Commit with clear messages
+
+\- Push to your fork and open a Pull Request
+
+
+
+\## 📝 Reporting Issues
+
+\- Use the GitHub Issues tab
+
+\- Provide a clear description of the problem
+
+\- Suggest possible solutions if you can
+
+
+
+\## 🔧 Submitting Pull Requests
+
+\- Link your PR to an issue
+
+\- Explain what problem you solved
+
+\- Keep changes focused and well-documented
+
+
+
+\## 📐 Coding Standards
+
+\- Write clean, readable code
+
+\- Document functions and modules
+
+\- Follow open-source best practices
+
+
+
+\---
+
+
+
+By contributing, you help BOS grow into a reliable, community-driven Internet Operating System.
+
+
+Bugema University looks forward to producing Open source Contributors for Africa and we can wait to see you there with Affiliation with big Open Source Communities lie Open Elements, We can't wait to have you there 
+
diff --git a/README.md b/README.md
index 2973e74..be1c923 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,108 @@
 # BOS
+
 BOS (Bugema Operating System) the internet OS! Free, Open Source, Self hostable
+
+
+
+\# BOS (Bugema Operating System)
+
+
+
+BOS is the \*\*Internet Operating System\*\* developed by the Bugema Open Source Community.
+
+It is free, open source, and self-hostable, designed to empower communities with digital tools.
+
+
+
+\---
+
+
+
+\## 🌍 Overview
+
+BOS aims to provide a lightweight, community-driven operating system for internet-based applications.
+
+It focuses on accessibility, collaboration, and open innovation.
+
+
+
+\---
+
+
+
+\## ⚙️ Installation
+
+1\. Clone the repository:
+
+   ```bash
+
+   git clone https://github.com/bos-com/BOS.git
+
+
+
+Navigate into the project:
+
+
+
+bash
+
+cd BOS
+
+Follow setup instructions (to be expanded as development grows).
+
+
+
+🚀 Usage
+
+Run BOS modules locally.
+
+
+
+Contribute new features or bug fixes.
+
+
+
+Share improvements with the community via pull requests.
+
+
+
+🤝 Contributing
+
+We welcome contributions!
+
+
+
+Fork the repository.
+
+
+
+Create a branch for your changes.
+
+
+
+Commit and push your updates.
+
+
+
+Open a Pull Request linked to an issue.
+
+
+
+
+
+📜 License
+
+This project is licensed under the MIT License.
+
+
+
+Push to GitHub:
+
+
+
+bash
+
+git push origin improve-readme
+
+Then you’ll be ready to open your first Pull Request for BOS.
+