A stunning, production-ready portfolio website to showcase professional certifications, achievements, and expertise with a beautiful black & white theme and smooth animations.
π Live Demo β’ π Documentation β’ π οΈ Installation β’ π¨ Customization
|
|
Make sure you have the following installed:
- Node.js (v18 or higher)
- npm or yarn
# Clone the repository
git clone https://github.com/AyushSingh360/portfolio.git
# Navigate to project directory
cd portfolio
# Install dependencies
npm install
# Start development server
npm run dev
π That's it! Your portfolio will be running at http://localhost:5173
Command | Description |
---|---|
npm run dev |
π Start development server |
npm run build |
π¦ Build for production |
npm run preview |
π Preview production build |
npm run lint |
π Run ESLint |
- Navigate to
src/components/Certificates.tsx
- Update the certificates array with your information:
const certificates: Certificate[] = [
{
id: 1,
title: "Your Certificate Title",
issuer: "Issuing Organization",
date: "2024",
description: "Detailed description of what this certificate validates...",
image: "/project/public/15.png",
credentialId: "YOUR-CREDENTIAL-ID",
verificationUrl: "https://verification-url.com"
},
// Add more certificates...
];
π Personal Information
Hero Section (src/components/Hero.tsx
):
// Update your name and title
<h1>Ayush Kumar</h1>
<p>Fresher</p>
About Section (src/components/About.tsx
):
// Update experience and location
<span>Experience: `` </span>
<span>Location: India, Bihar</span>
Contact Information (src/components/Contact.tsx
):
// Update contact details
<p>ayushsingh21109@gmail.com</p>
<p>+1 (555) 123-4567</p>
π¨ Styling & Theme
Colors: Modify tailwind.config.js
for custom colors
Animations: Update animation classes in components
Layout: Adjust grid layouts and spacing in component files
π§ Skills & Expertise
Update src/components/Skills.tsx
:
const skillCategories = [
{
title: "Your Skill Category",
icon: <YourIcon size={24} />,
skills: ["Skill 1", "Skill 2", "Skill 3"]
}
];
professional-portfolio/
βββ π public/
β βββ Images
βββ π src/
β βββ π components/
β β βββ About.tsx # About section
β β βββ Certificates.tsx # Certificates showcase
β β βββ Contact.tsx # Contact information
β β βββ DarkModeToggle.tsx # Theme switcher
β β βββ Footer.tsx # Footer component
β β βββ Header.tsx # Navigation header
β β βββ Hero.tsx # Hero section
β β βββ Skills.tsx # Skills showcase
β βββ π hooks/
β β βββ useDarkMode.ts # Dark mode logic
β βββ App.tsx # Main app component
β βββ index.css # Global styles
β βββ main.tsx # App entry point
βββ π index.html
βββ π package.json
βββ π tailwind.config.js
βββ π tsconfig.json
βββ π vite.config.ts
- Interactive Cards - Click to view detailed information
- Verification Links - Direct links to credential verification
- Responsive Design - Perfect display on all screen sizes
- System Preference Detection - Respects user's OS theme
- Persistent Storage - Remembers user's choice
- Smooth Transitions - Elegant theme switching animations
- Mobile First - Optimized for mobile devices
- Flexible Grid - Adapts to any screen size
- Touch Friendly - Perfect for mobile interactions
# Build the project
npm run build
# Deploy to Netlify
# Drag and drop the 'dist' folder to Netlify
# Install Vercel CLI
npm i -g vercel
# Deploy
vercel --prod
# Install gh-pages
npm install --save-dev gh-pages
# Add to package.json scripts
"deploy": "gh-pages -d dist"
# Deploy
npm run build && npm run deploy
Contributions are welcome! Here's how you can help:
- π΄ Fork the repository
- πΏ Create a feature branch (
git checkout -b feature/amazing-feature
) - πΎ Commit your changes (
git commit -m 'Add amazing feature'
) - π€ Push to the branch (
git push origin feature/amazing-feature
) - π Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- React Team - For the amazing React framework
- Tailwind CSS - For the utility-first CSS framework
- Lucide - For the beautiful icon set
- Pexels - For the high-quality stock images
- Vite - For the lightning-fast build tool
If you have any questions or need help customizing your portfolio:
- π§ Email: ayushsingh21109@gmail.com
- π¬ Issues: GitHub Issues
- β¨ linkedin: https://www.linkedin.com/in/ayushsingh360/
- β€οΈ LIVE: https://portfolio-ashs-projects-0cd628f6.vercel.app/