Skip to content

Commit 5d4dd1c

Browse files
committed
Updated Readme.md
1 parent f04e3ba commit 5d4dd1c

File tree

1 file changed

+129
-7
lines changed

1 file changed

+129
-7
lines changed

README.md

+129-7
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,134 @@
1-
# React + Vite
1+
Below is the complete raw content for your README.md file. Simply copy and paste this content into a file named `README.md` in your repository.
22

3-
This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
3+
```markdown
4+
# Hassan Shahzad | Portfolio Website
45

5-
Currently, two official plugins are available:
6+
Welcome to my portfolio website repository! This project showcases my work, skills, and experiences with a modern, responsive design built using React, Vite, and Mantine UI. The website is automatically deployed on GitHub Pages at [https://hxndev.github.io/](https://hxndev.github.io/).
67

7-
- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react/README.md) uses [Babel](https://babeljs.io/) for Fast Refresh
8-
- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh
8+
## Table of Contents
99

10-
## Expanding the ESLint configuration
10+
- [Demo](#demo)
11+
- [Features](#features)
12+
- [Technologies](#technologies)
13+
- [Installation](#installation)
14+
- [Usage](#usage)
15+
- [Deployment](#deployment)
16+
- [Project Structure](#project-structure)
17+
- [Contributing](#contributing)
18+
- [License](#license)
19+
- [Contact](#contact)
1120

12-
If you are developing a production application, we recommend using TypeScript and enable type-aware lint rules. Check out the [TS template](https://github.com/vitejs/vite/tree/main/packages/create-vite/template-react-ts) to integrate TypeScript and [`typescript-eslint`](https://typescript-eslint.io) in your project.
21+
## Demo
22+
23+
Visit the live website: [https://hxndev.github.io/](https://hxndev.github.io/)
24+
25+
## Features
26+
27+
- **Responsive Design:** Adapts seamlessly to mobile, tablet, and desktop screens.
28+
- **Project Showcase:** Explore detailed project pages with filtering options.
29+
- **Smooth Animations:** Enjoy dynamic transitions powered by GSAP.
30+
- **Modern UI:** Crafted with Mantine UI and Tabler Icons for a sleek look.
31+
- **Optimized Performance:** Built with Vite for lightning-fast builds and performance.
32+
- **Automated Deployment:** GitHub Actions ensure your changes are live as soon as you push to the main branch.
33+
34+
## Technologies
35+
36+
- **React:** For building interactive user interfaces.
37+
- **Vite:** A modern build tool for fast development.
38+
- **React Router:** For seamless client-side routing.
39+
- **Mantine UI:** For a robust and stylish component library.
40+
- **GSAP:** For creating smooth, high-performance animations.
41+
- **GitHub Actions:** Automating CI/CD and deployments.
42+
- **GitHub Pages:** Hosting the live website.
43+
44+
## Installation
45+
46+
1. **Clone the repository:**
47+
48+
```bash
49+
git clone https://github.com/HxnDev/hxndev.github.io.git
50+
cd hxndev.github.io
51+
```
52+
53+
2. **Install dependencies:**
54+
55+
```bash
56+
npm install
57+
```
58+
59+
## Usage
60+
61+
### Development
62+
63+
Start the development server with hot reloading:
64+
65+
```bash
66+
npm run dev
67+
```
68+
69+
Open [http://localhost:3000](http://localhost:3000) in your browser to view the website.
70+
71+
### Production Build
72+
73+
Generate an optimized production build:
74+
75+
```bash
76+
npm run build
77+
```
78+
79+
The build output will be located in the `dist` directory.
80+
81+
### Preview the Production Build
82+
83+
To preview the production build locally:
84+
85+
```bash
86+
npm run preview
87+
```
88+
89+
## Deployment
90+
91+
This project is configured for automated deployment using GitHub Actions. Every push to the `main` branch triggers a build and deploys the `dist` folder to the `gh-pages` branch.
92+
93+
**Live Website:** [https://hxndev.github.io/](https://hxndev.github.io/)
94+
95+
## Project Structure
96+
97+
```
98+
hxndev.github.io/
99+
├── .github/
100+
│ └── workflows/
101+
│ └── deploy.yml # GitHub Actions workflow for deployment
102+
├── public/ # Public assets (if any)
103+
├── src/
104+
│ ├── assets/ # Images and other assets
105+
│ ├── components/ # Reusable React components
106+
│ ├── context/ # React context providers
107+
│ ├── hooks/ # Custom React hooks
108+
│ ├── pages/ # Page components (e.g., Projects, About, Contact)
109+
│ ├── App.jsx # Main application component
110+
│ ├── main.jsx # Entry point for React
111+
│ └── index.css # Global styles
112+
├── index.html # HTML template processed by Vite
113+
├── package.json # Project configuration and dependencies
114+
├── vite.config.js # Vite configuration
115+
└── README.md # This file
116+
```
117+
118+
## Contributing
119+
120+
Contributions, issues, and feature requests are welcome!
121+
Please check the [issues page](https://github.com/HxnDev/hxndev.github.io/issues) for ideas or open a new issue if you have a suggestion.
122+
123+
## License
124+
125+
Distributed under the MIT License. See `LICENSE` for more information.
126+
127+
## Contact
128+
129+
**Hassan Shahzad**
130+
Email: [your-email@example.com](mailto:your-email@example.com)
131+
Portfolio: [https://hxndev.github.io/](https://hxndev.github.io/)
132+
```
133+
134+
Simply download or create a new file named `README.md`, paste the above content into it, and save it in your repository. This will give you an amazing README file for your portfolio website.

0 commit comments

Comments
 (0)