8000 GitHub - AyushSingh360/Portfolio
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

AyushSingh360/Portfolio

Repository files navigation

πŸ† Professional Portfolio - Certificates & Achievements

Portfolio Banner

React TypeScript Tailwind CSS Vite

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


✨ Features

🎨 Design Excellence

  • Minimalist B&W Theme - Clean, professional aesthetic
  • Dark Mode Support - Seamless theme switching
  • Responsive Design - Perfect on all devices
  • Smooth Animations - Engaging hover effects and transitions
  • Production Ready - Optimized for performance

πŸš€ Modern Technology

  • React 18 - Latest React features
  • TypeScript - Type-safe development
  • Tailwind CSS - Utility-first styling
  • Vite - Lightning-fast build tool
  • Lucide Icons - Beautiful, consistent icons

πŸ–ΌοΈ Screenshots

🌟 Hero Section

Hero Section

πŸ† Certificates Showcase

Certificates Section

πŸŒ™ Dark Mode

Dark Mode

πŸš€ Quick Start

Prerequisites

Make sure you have the following installed:

  • Node.js (v18 or higher)
  • npm or yarn

Installation

# 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

πŸ› οΈ Available Scripts

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

🎨 Customization Guide

πŸ“ Adding Your Certificates

  1. Navigate to src/components/Certificates.tsx
  2. 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...
];

🎯 Personalizing Content

πŸ“‹ 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"]
  }
];

πŸ“ Project Structure

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

🌟 Key Components

πŸ† Certificate Modal System

  • Interactive Cards - Click to view detailed information
  • Verification Links - Direct links to credential verification
  • Responsive Design - Perfect display on all screen sizes

πŸŒ™ Dark Mode Implementation

  • System Preference Detection - Respects user's OS theme
  • Persistent Storage - Remembers user's choice
  • Smooth Transitions - Elegant theme switching animations

πŸ“± Responsive Design

  • Mobile First - Optimized for mobile devices
  • Flexible Grid - Adapts to any screen size
  • Touch Friendly - Perfect for mobile interactions

πŸš€ Deployment

Netlify (Recommended)

# Build the project
npm run build

# Deploy to Netlify
# Drag and drop the 'dist' folder to Netlify

Vercel

# Install Vercel CLI
npm i -g vercel

# Deploy
vercel --prod

GitHub Pages

# 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

🀝 Contributing

Contributions are welcome! Here's how you can help:

  1. 🍴 Fork the repository
  2. 🌿 Create a feature branch (git checkout -b feature/amazing-feature)
  3. πŸ’Ύ Commit your changes (git commit -m 'Add amazing feature')
  4. πŸ“€ Push to the branch (git push origin feature/amazing-feature)
  5. πŸ”„ Open a Pull Request

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ™ Acknowledgments

  • 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

πŸ“ž Support

If you have any questions or need help customizing your portfolio:


🌟 Star this repository if it helped you! 🌟

Made with ❀️ and dedication to excellence

GitHub stars GitHub forks

0