diff --git a/README.md b/README.md
index 9e2fc5d..d8e389b 100644
--- a/README.md
+++ b/README.md
@@ -1,40 +1,182 @@
-# EventHive — Decentralized Event Ticketing
+# Event NFT Ticketing Platform
 
-This repo is a starter scaffold for a decentralized event ticketing platform using:
+A decentralized event management and ticketing system built on Ethereum using ERC-721 NFTs. This project enables organizers to create events and issue NFT-based tickets, while users can securely purchase, transfer, and verify tickets on-chain.
 
-- Smart contracts: Foundry (Solidity)
-- Frontend: React + Vite
-- Wallet login: WalletConnect (Web3Modal) + placeholder integration for Reown AppKit
-- Target network for deployment: Base (mainnet)
+---
 
-Quick start
+## Overview
 
-1. Clone the repo
-2. Smart contracts (Foundry):
+The Event NFT Ticketing Platform consists of two core smart contracts:
+
+* **EventTicket** – An ERC-721 NFT contract representing tickets for a single event.
+* **EventFactory** – A factory contract that deploys new EventTicket contracts for organizers.
+
+Each event is isolated in its own smart contract, ensuring clean separation of state, ownership, and ticket supply.
+
+---
+
+## Key Features
+
+### For Organizers
+
+* Create events with custom metadata (name, date, location, description)
+* Define ticket price and maximum ticket supply
+* Mint NFT tickets automatically on purchase
+* Withdraw ticket sale proceeds
+* Mark tickets as used (entry validation)
+
+### For Attendees
+
+* Purchase single or multiple tickets
+* Receive tickets as ERC-721 NFTs
+* Transfer tickets freely before use
+* Verify ticket ownership on-chain
+
+### Platform
+
+* Factory pattern for scalable event creation
+* Fully compatible with OpenZeppelin v5
+* Solidity ^0.8.x with modern security defaults
+
+---
+
+## Smart Contracts
+
+### EventFactory
+
+Responsible for deploying new EventTicket contracts.
+
+**Responsibilities:**
+
+* Create new events
+* Track all deployed events
+* Track events by organizer
+
+**Key Functions:**
+
+* `createEvent(...)` – Deploy a new event contract
+* `getAllEvents()` – List all events
+* `getOrganizerEvents(address)` – List events created by an organizer
+* `getEventsPaginated(offset, limit)` – Paginated event discovery
+
+---
+
+### EventTicket
+
+ERC-721 NFT contract representing tickets for a single event.
+
+**Responsibilities:**
+
+* Mint NFT tickets
+* Enforce max ticket supply
+* Track used tickets
+* Handle ticket transfers
+* Manage ticket sale funds
+
+**Key Functions:**
+
+* `mintTicket()` – Buy one ticket
+* `mintTickets(uint256 quantity)` – Buy multiple tickets
+* `useTicket(uint256 tokenId)` – Mark ticket as used (organizer only)
+* `getUserTickets(address)` – Fetch tickets owned by a user
+* `withdraw()` – Withdraw ticket sale proceeds
+
+---
+
+## Ticket Lifecycle
+
+1. Organizer creates an event via `EventFactory`
+2. Users purchase tickets (NFTs are minted)
+3. Tickets can be transferred freely
+4. Organizer validates entry by calling `useTicket(tokenId)`
+5. Used tickets cannot be reused
+
+---
+
+## Security Considerations
+
+* Built on Solidity ^0.8.x (overflow checks enabled)
+* Uses OpenZeppelin v5 audited contracts
+* Organizer-only access for sensitive operations
+* Ticket usage tracked on-chain to prevent reuse
+* Ether transfers use `call` (not `transfer`)
+
+---
+
+## Development Setup
+
+### Prerequisites
+
+* Node.js >= 18
+* Foundry or Hardhat
+* Solidity ^0.8.20
+
+### Install Dependencies
+
+```bash
+npm install
+```
+
+or
 
 ```bash
-# install foundry: https://book.getfoundry.sh/
 forge install
-# compile
-forge build
-# run the deploy script (example):
-export BASE_RPC_URL="https://mainnet.base.org"
-export PRIVATE_KEY="your_deployer_private_key"
-forge script script/Deploy.s.sol:DeployScript --rpc-url $BASE_RPC_URL --broadcast
 ```
 
-3. Frontend (React + Vite)
+---
+
+## Compile Contracts
+
+### Hardhat
 
 ```bash
-cd frontend
-npm install
-npm run dev
+npx hardhat compile
 ```
 
-Environment variables are shown in `.env.example` files.
+### Foundry
+
+```bash
+forge build
+```
+
+---
+
+## Deployment
+
+Deploy `EventFactory` first. Each event will be deployed automatically via the factory.
+
+```solidity
+EventFactory factory = new EventFactory(platformWallet);
+```
+
+---
+
+## Example Use Cases
+
+* Conferences & Meetups
+* Concerts & Festivals
+* Web3 Hackathons
+* Private Community Events
+* DAO Governance Events
+
+---
+
+## Roadmap
+
+* Secondary marketplace integration
+* QR-code based ticket scanning
+* Off-chain metadata hosting
+* Multi-chain deployments
+* Royalty support (ERC-2981)
+
+---
+
+## License
+
+MIT License
 
-Notes
+---
 
-- This is a scaffold. Replace placeholder keys, review security, add tests, and audit before production deploy.
+## Disclaimer
 
-# EventHive
+This project is provided as-is and has not been audited. Use at your own risk. Always conduct a professional security audit before deploying to mainnet.