|
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. |
2 | 2 |
|
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 |
4 | 5 |
|
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/). |
6 | 7 |
|
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 |
9 | 9 |
|
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) |
11 | 20 |
|
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