diff --git a/B/basic-blockchain/README.md b/B/basic-blockchain/README.md
new file mode 100644
index 00000000..e960ee72
--- /dev/null
+++ b/B/basic-blockchain/README.md
@@ -0,0 +1,65 @@
+# Simple Blockchain Implementation
+
+This is a basic implementation of a blockchain using Python and Flask.
+
+## Table of Contents
+
+- [Introduction](#introduction)
+- [Features](#features)
+- [Getting Started](#getting-started)
+- [Usage](#usage)
+- [API Endpoints](#api-endpoints)
+- [Contributing](#contributing)
+- [License](#license)
+
+## Introduction
+
+This project is a simple blockchain implementation using Python and the Flask web framework. It provides basic functionality for creating a blockchain, mining new blocks, and checking the validity of the blockchain.
+
+## Features
+
+- Create new blocks with proof of work
+- Mine new blocks with a simple proof of work algorithm
+- Check the validity of the blockchain
+
+## Getting Started
+
+To get started with this project, follow these steps:
+
+1. Clone this repository to your local machine.
+2. Make sure you have Python and Flask installed.
+3. Run the Flask application to start the blockchain server.
+
+## Usage
+
+To use the blockchain, you can interact with it through API endpoints. Here are the available endpoints:
+
+## API Endpoints
+
+- `GET /mine_block`: Mine a new block.
+- `GET /get_chain`: Get the full blockchain.
+- `GET /is_valid`: Check the validity of the blockchain.
+
+For more detailed usage and API documentation, please refer to the code.
+
+## Contributing
+
+If you'd like to contribute to this project, please follow these steps:
+
+1. Fork the repository to your GitHub account.
+2. Create a new branch for your changes.
+3. Make your changes and commit them.
+4. Push your changes to your fork.
+5. Create a pull request to this repository.
+
+Please make sure to follow the project's code of conduct and contribution guidelines.
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](./LICENSE) file for details.
+
+---
+
+Enjoy using this simple blockchain implementation!
+
+For more details and to run the code, please check the provided Python code file.