https://github.com/athulsabu2002/react-portfolio
https://github.com/athulsabu2002/react-portfolio
Last synced: 7 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/athulsabu2002/react-portfolio
- Owner: AthulSabu2002
- Created: 2025-02-02T09:11:12.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-02-02T09:44:42.000Z (8 months ago)
- Last Synced: 2025-02-02T10:27:47.498Z (8 months ago)
- Language: JavaScript
- Size: 2.06 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# React + Vite Project
A modern, high-performance React application template powered by Vite, designed for scalable and maintainable web development.
## ✨ Features
- ⚡️ Lightning Fast HMR with sub-50ms updates
- 🔧 Robust ESLint Configuration for code quality
- ⚛️ React 18 with latest features and improvements
- 📦 Vite 4 build tooling
- 🎯 TypeScript support out of the box
- 📱 Mobile-first responsive design
- 🔍 SEO-friendly setup
- 🎨 CSS-in-JS support
## 🚀 Getting Started
### Prerequisites
- Node.js 16.x or higher
- npm 7.x or higher
### Installation
1. Clone the repository:
```bash
git clone https://github.com/AthulSabu2002/portfolio-react.git
cd portfolio-react
```
2. Install dependencies:
```bash
npm install
```
3. Start the development server:
```bash
npm run dev
```
Visit http://localhost:5173 to view your application
## 📝 Available Scripts
- `npm run dev` - Launch development server with hot-reload
- `npm run build` - Create production build
- `npm run preview` - Preview production build locally
- `npm run lint` - Lint project files
- `npm test` - Run test suite (if configured)
## 🔌 Plugins & Configuration
### Official Vite Plugins
- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react/README.md)
- Uses Babel for Fast Refresh
- Provides advanced JSX support
- Enables development server features
- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react-swc)
- Uses SWC for Fast Refresh
- Offers 20x faster compilation
- Rust-based performance
## 📁 Project Structure
```
project-root/
├── src/
│ ├── components/
│ ├── pages/
│ ├── assets/
│ ├── hooks/
│ ├── utils/
│ ├── App.tsx
│ └── main.tsx
├── public/
├── index.html
└── package.json
```
## 🤝 Contributing
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit changes (`git commit -m 'Add amazing feature'`)
4. Push to branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
## 🔧 Troubleshooting
Common issues and their solutions:
- **HMR not working**: Clear your browser cache and restart the dev server
- **Build failures**: Ensure all dependencies are properly installed
- **Type errors**: Check TypeScript configuration and types definitions
## 📚 Resources
- [Vite Documentation](https://vitejs.dev/)
- [React Documentation](https://reactjs.org/)
- [TypeScript Documentation](https://www.typescriptlang.org/)