Skip to content

Commit 0271782

Browse files
committed
Update Readme
1 parent ddf3e02 commit 0271782

File tree

1 file changed

+253
-1
lines changed

1 file changed

+253
-1
lines changed

README.md

Lines changed: 253 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,255 @@
11
# Personal Portfolio Website
22

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

Comments
 (0)