diff --git a/README.md b/README.md
index e69de29..5a570e1 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,104 @@
+# Portfolio Page
+
+A modern, responsive portfolio website built with React, TypeScript, and Vite. This project showcases professional skills, projects, certifications, and services in an elegant and interactive interface.
+
+## About This Project
+
+This portfolio website serves as a comprehensive showcase of professional experience and capabilities. It features:
+
+- **Modern Design**: Clean, responsive design that works seamlessly across all devices
+- **Interactive Sections**: Engaging hero section, about me, skills showcase, project gallery, certifications, and services
+- **Theme Support**: Built-in light/dark theme toggle for enhanced user experience
+- **Performance Optimized**: Built with Vite for fast loading and optimal performance
+- **TypeScript**: Fully typed codebase for better development experience and code reliability
+
+## Features
+
+- **Hero Section**: Eye-catching introduction with personal branding
+- **About Section**: Professional background and personal story
+- **Skills Section**: Technical expertise with visual skill indicators
+- **Projects Section**: Portfolio of completed projects with descriptions and links
+- **Certifications Section**: Professional certifications and achievements
+- **Services Section**: Available professional services
+- **Contact Section**: Easy ways to get in touch
+- **Responsive Navigation**: Mobile-friendly navigation with hamburger menu
+
+## Technology Stack
+
+- **Frontend**: React 18 with TypeScript
+- **Build Tool**: Vite for fast development and building
+- **Styling**: SCSS with modular architecture
+- **Code Quality**: ESLint for consistent code standards
+- **AI Assistant**: Built with the assistance of GitHub Copilot for enhanced development productivity
+
+## Planned Additions
+
+### Protected Admin Panel
+
+A secure, password-protected administrative interface is planned for future releases. This admin panel will provide:
+
+- **Content Management**: Easy editing of personal information, skills, and project details
+- **Project Management**: Add, edit, and remove projects from the portfolio
+- **Skills Management**: Update technical skills and proficiency levels
+- **Certifications Management**: Maintain and update professional certifications
+- **Real-time Updates**: Changes will be reflected immediately on the public portfolio
+- **Secure Authentication**: Protected access to prevent unauthorized modifications
+
+This feature will enable dynamic content updates without requiring code changes, making the portfolio easily maintainable and always up-to-date.
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js (version 18 or higher)
+- npm or yarn package manager
+
+### Installation
+
+1. Clone the repository:
+
+```bash
+git clone https://github.com/LuciusShadow/portfolio-page.git
+cd portfolio-page
+```
+
+2. Install dependencies:
+
+```bash
+npm install
+```
+
+3. Start the development server:
+
+```bash
+npm run dev
+```
+
+4. Open your browser and navigate to `http://localhost:5173`
+
+### Building for Production
+
+```bash
+npm run build
+```
+
+The built files will be available in the `dist` directory.
+
+## Project Structure
+
+```
+src/
+├── app/              # Main application component
+├── components/       # Reusable UI components
+├── config/          # Configuration files
+├── data/            # Data type definitions
+└── scss/            # Styling with SCSS modules
+```
+
+## Contributing
+
+This is a personal portfolio project. While contributions are not expected, suggestions and feedback are always welcome!
+
+## License
+
+This project is for personal use and portfolio demonstration purposes.