diff --git a/synapse-frontend/README.md b/synapse-frontend/README.md
index e16d995..e64a3bf 100644
--- a/synapse-frontend/README.md
+++ b/synapse-frontend/README.md
@@ -1,18 +1,110 @@
-# React + Vite
+
-This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
+# Synapse
-Currently, two official plugins are available:
+Modern React application powered by Vite ⚡
-- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Oxc](https://oxc.rs)
-- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/)
+[](https://react.dev/)
+[](https://vitejs.dev/)
+[](https://eslint.org/)
+
+
+
+---
+
+## Overview
+
+Synapse is a frontend application built using React and Vite, designed for high performance, fast development experience, and scalable architecture.
+
+The project includes Hot Module Replacement (HMR), ESLint integration, and support for modern React tooling.
+
+---
+
+## Tech Stack
+
+| Technology | Purpose |
+|------------|---------|
+| React | UI Development |
+| Vite | Build Tool |
+| ESLint | Code Quality |
+| JavaScript | Application Logic |
+
+---
+
+## Available Plugins
+
+Currently supported official React plugins:
+
+- [`@vitejs/plugin-react`](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) — Uses Oxc
+- [`@vitejs/plugin-react-swc`](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) — Uses SWC
+
+---
## React Compiler
-The React Compiler is enabled on this template. See [this documentation](https://react.dev/learn/react-compiler) for more information.
+This project has the React Compiler enabled.
+
+Read the official documentation:
+https://react.dev/learn/react-compiler
+
+> Enabling the compiler may impact development and build performance.
+
+---
+
+## Project Setup
+
+### Clone Repository
+
+```bash
+git clone
+```
+
+### Install Dependencies
+
+```bash
+npm install
+```
+
+### Start Development Server
+
+```bash
+npm run dev
+```
+
+### Production Build
+
+```bash
+npm run build
+```
+
+### Preview Build
+
+```bash
+npm run preview
+```
+
+---
+
+## ESLint Configuration
+
+For production-grade applications, TypeScript with type-aware lint rules is recommended.
+
+Explore:
+- https://typescript-eslint.io
+- https://github.com/vitejs/vite/tree/main/packages/create-vite/template-react-ts
+
+---
+
+## Contribution Workflow
+
+```bash
+Create Branch → Make Changes → Commit → Push → Pull Request
+```
+
+---
-Note: This will impact Vite dev & build performances.
+
-## Expanding the ESLint configuration
+Made with React + Vite
-If you are developing a production application, we recommend using TypeScript with type-aware lint rules enabled. Check out the [TS template](https://github.com/vitejs/vite/tree/main/packages/create-vite/template-react-ts) for information on how to integrate TypeScript and [`typescript-eslint`](https://typescript-eslint.io) in your project.
+
\ No newline at end of file