|
1 | 1 | # Personal Portfolio Website |
2 | 2 |
|
3 | | -Coming Soon! |
| 3 | +A modern, responsive portfolio website built with React and Material-UI, showcasing professional experience, projects, and skills. |
| 4 | + |
| 5 | +## 🚀 Quick Start |
| 6 | + |
| 7 | +### Prerequisites |
| 8 | + |
| 9 | +- Node.js (version 14 or higher) |
| 10 | +- npm or yarn package manager |
| 11 | + |
| 12 | +### Running Locally |
| 13 | + |
| 14 | +1. **Clone the repository** |
| 15 | + ```bash |
| 16 | + git clone https://github.com/abhinavchat/abhinavchat-portfolio.git |
| 17 | + cd abhinavchat-portfolio |
| 18 | + ``` |
| 19 | + |
| 20 | +2. **Install dependencies** |
| 21 | + ```bash |
| 22 | + npm install |
| 23 | + ``` |
| 24 | + |
| 25 | +3. **Start the development server** |
| 26 | + ```bash |
| 27 | + npm start |
| 28 | + ``` |
| 29 | + |
| 30 | +4. **Open your browser** |
| 31 | + Navigate to `http://localhost:3000` to view the portfolio |
| 32 | + |
| 33 | +### Available Scripts |
| 34 | + |
| 35 | +- `npm start` - Runs the app in development mode |
| 36 | +- `npm run build` - Builds the app for production |
| 37 | +- `npm test` - Launches the test runner |
| 38 | +- `npm run deploy` - Deploys to GitHub Pages |
| 39 | + |
| 40 | +## 📝 Updating Your Resume/Portfolio |
| 41 | + |
| 42 | +All portfolio content is managed through the `src/portfolio.js` file. This file contains several configuration objects that control different sections of your portfolio. |
| 43 | + |
| 44 | +### Key Configuration Sections |
| 45 | + |
| 46 | +#### 1. Personal Information (`about` object) |
| 47 | +```javascript |
| 48 | +const about = { |
| 49 | + name: 'Your Full Name', |
| 50 | + role: 'Your Job Title', |
| 51 | + description: 'Your professional summary...', |
| 52 | + resume: process.env.PUBLIC_URL + '/resume', |
| 53 | + social: { |
| 54 | + linkedin: 'https://www.linkedin.com/in/yourprofile/', |
| 55 | + github: 'https://github.com/yourusername', |
| 56 | + }, |
| 57 | +} |
| 58 | +``` |
| 59 | + |
| 60 | +#### 2. Experience (`resume.experience` array) |
| 61 | +Located in the `resume` object, add/edit work experience: |
| 62 | +```javascript |
| 63 | +{ |
| 64 | + position: 'Job Title', |
| 65 | + company: 'Company Name', |
| 66 | + url: 'https://company-website.com', |
| 67 | + period: 'Start Date - End Date', |
| 68 | + location: 'City, State/Country', |
| 69 | + summary: 'Brief description of the role...', |
| 70 | + achievements: [ |
| 71 | + 'Achievement or responsibility 1', |
| 72 | + 'Achievement or responsibility 2', |
| 73 | + // Add more achievements as needed |
| 74 | + ] |
| 75 | +} |
| 76 | +``` |
| 77 | + |
| 78 | +#### 3. Education (`resume.education` array) |
| 79 | +```javascript |
| 80 | +{ |
| 81 | + degree: 'Degree Name', |
| 82 | + institution: 'University/Institution Name', |
| 83 | + url: 'https://institution-website.com', |
| 84 | + period: 'Start Year - End Year', |
| 85 | + location: 'City, State/Country', |
| 86 | + studyType: 'Type of degree' |
| 87 | +} |
| 88 | +``` |
| 89 | + |
| 90 | +#### 4. Certifications (`resume.certifications` array) |
| 91 | +```javascript |
| 92 | +{ |
| 93 | + title: 'Certification Name', |
| 94 | + id: 'Certificate ID (optional)', |
| 95 | + issuer: 'Issuing Organization' |
| 96 | +} |
| 97 | +``` |
| 98 | + |
| 99 | +#### 5. Projects (`projects` array) |
| 100 | +```javascript |
| 101 | +{ |
| 102 | + name: 'Project Name', |
| 103 | + description: 'Project description...', |
| 104 | + stack: ['Technology1', 'Technology2', 'Technology3'], |
| 105 | + sourceCode: 'https://github.com/username/repo', |
| 106 | + livePreview: 'https://project-demo-url.com', |
| 107 | +} |
| 108 | +``` |
| 109 | + |
| 110 | +#### 6. Skills (`skills` object) |
| 111 | +Organized by categories: |
| 112 | +```javascript |
| 113 | +const skills = { |
| 114 | + // List your skills by category |
| 115 | + 'Programming Languages': ['JavaScript', 'Python', 'Java'], |
| 116 | + 'Frontend': ['React', 'Angular', 'Vue.js'], |
| 117 | + 'Backend': ['Node.js', 'Express', 'Django'], |
| 118 | + 'Databases': ['MongoDB', 'PostgreSQL', 'MySQL'], |
| 119 | + // Add more categories as needed |
| 120 | +} |
| 121 | +``` |
| 122 | + |
| 123 | +### Step-by-Step Update Process |
| 124 | + |
| 125 | +1. **Open the portfolio configuration file** |
| 126 | + ```bash |
| 127 | + src/portfolio.js |
| 128 | + ``` |
| 129 | + |
| 130 | +2. **Update personal information** |
| 131 | + - Modify the `about` object with your details |
| 132 | + - Update social media links |
| 133 | + |
| 134 | +3. **Add/Update work experience** |
| 135 | + - Navigate to the `resume.experience` array |
| 136 | + - Add new positions or edit existing ones |
| 137 | + - Use the format shown above |
| 138 | + |
| 139 | +4. **Update education** |
| 140 | + - Modify the `resume.education` array |
| 141 | + - Add your educational background |
| 142 | + |
| 143 | +5. **Add certifications** |
| 144 | + - Update the `resume.certifications` array |
| 145 | + - Include relevant professional certifications |
| 146 | + |
| 147 | +6. **Update projects** |
| 148 | + - Modify the `projects` array |
| 149 | + - Showcase your best work with descriptions and links |
| 150 | + |
| 151 | +7. **Update skills** |
| 152 | + - Edit the `skills` object |
| 153 | + - Organize skills by relevant categories |
| 154 | + |
| 155 | +8. **Test your changes** |
| 156 | + ```bash |
| 157 | + npm start |
| 158 | + ``` |
| 159 | + Review your changes at `http://localhost:3000` |
| 160 | + |
| 161 | +9. **Build for production** |
| 162 | + ```bash |
| 163 | + npm run build |
| 164 | + ``` |
| 165 | + |
| 166 | +### Contact Information (`contact` object) |
| 167 | +```javascript |
| 168 | +const contact = { |
| 169 | + email: 'your.email@example.com', |
| 170 | + phone: '+1234567890', |
| 171 | + location: 'Your City, State/Country' |
| 172 | +} |
| 173 | +``` |
| 174 | + |
| 175 | +## 🎨 Customization |
| 176 | + |
| 177 | +### Theme Configuration |
| 178 | +The `theme` object controls the visual appearance: |
| 179 | +- Colors, typography, spacing |
| 180 | +- Component styling |
| 181 | +- Responsive breakpoints |
| 182 | + |
| 183 | +### UI Configuration |
| 184 | +The `uiConfig` object controls: |
| 185 | +- Animation settings |
| 186 | +- Section visibility |
| 187 | +- Layout preferences |
| 188 | + |
| 189 | +## 📦 Deployment |
| 190 | + |
| 191 | +### GitHub Pages (Recommended) |
| 192 | +1. Update the `homepage` field in `package.json` with your GitHub Pages URL |
| 193 | +2. Run the deployment command: |
| 194 | + ```bash |
| 195 | + npm run deploy |
| 196 | + ``` |
| 197 | + |
| 198 | +### Manual Deployment |
| 199 | +1. Build the project: |
| 200 | + ```bash |
| 201 | + npm run build |
| 202 | + ``` |
| 203 | +2. Deploy the `build` folder to your hosting provider |
| 204 | + |
| 205 | +## 📁 Project Structure |
| 206 | + |
| 207 | +``` |
| 208 | +src/ |
| 209 | +├── components/ # React components |
| 210 | +├── pages/ # Page components |
| 211 | +├── portfolio.js # Main configuration file |
| 212 | +├── App.js # Main application component |
| 213 | +└── index.js # Application entry point |
| 214 | +``` |
| 215 | + |
| 216 | +## 🔧 Development Tips |
| 217 | + |
| 218 | +- **Hot Reloading**: Changes to `portfolio.js` will automatically refresh the browser |
| 219 | +- **Data Validation**: The app includes built-in validation for required fields |
| 220 | +- **Responsive Design**: All components are mobile-responsive by default |
| 221 | +- **SEO Friendly**: Includes meta tags and structured data for better search engine visibility |
| 222 | + |
| 223 | +## 📋 Common Tasks |
| 224 | + |
| 225 | +### Adding a New Job Experience |
| 226 | +1. Open `src/portfolio.js` |
| 227 | +2. Locate `resume.experience` array |
| 228 | +3. Add a new object with your job details |
| 229 | +4. Save and check the preview |
| 230 | + |
| 231 | +### Updating Skills |
| 232 | +1. Find the `skills` object in `src/portfolio.js` |
| 233 | +2. Add new categories or update existing ones |
| 234 | +3. Skills are automatically organized and displayed |
| 235 | + |
| 236 | +### Adding Projects |
| 237 | +1. Locate the `projects` array |
| 238 | +2. Add project objects with name, description, stack, and links |
| 239 | +3. Projects support GitHub links and live previews |
| 240 | + |
| 241 | +## 🤝 Contributing |
| 242 | + |
| 243 | +1. Fork the repository |
| 244 | +2. Create a feature branch |
| 245 | +3. Make your changes |
| 246 | +4. Test thoroughly |
| 247 | +5. Submit a pull request |
| 248 | + |
| 249 | +## 📄 License |
| 250 | + |
| 251 | +This project is open source and available under the [MIT License](LICENSE). |
| 252 | + |
| 253 | +--- |
| 254 | + |
| 255 | +**Need help?** Check the `src/portfolio.js` file for examples and detailed comments on each configuration option. |
0 commit comments