Skip to content

Repository files navigation

Portfolio Website

A modern, responsive portfolio website built with React, TypeScript, Tailwind CSS, and Framer Motion. This portfolio showcases projects, skills, education, certifications, and open source contributions with smooth animations and a beautiful UI.

🎬 Demo

Demo

πŸ“Έ Screenshots

Homepage

Hero-section

About Section

About-section

Skills

Skills

Projects

Projects

Open Source

Open-Source

🌟 Features

  • Responsive Design - Works perfectly on desktop, tablet, and mobile devices
  • Smooth Animations - Framer Motion animations for engaging user experience
  • Modern UI - Built with Shadcn UI components and Tailwind CSS
  • Dark Mode Support - Beautiful dark and light theme support
  • Multiple Sections:
    • Hero Section
    • About
    • Skills
    • Projects
    • Education
    • Certifications
    • Open Source Contributions
    • Contact
  • Navigation - Smooth navigation between sections
  • SEO Optimized - Proper meta tags and semantic HTML

πŸ› οΈ Tech Stack

  • Frontend Framework: React 18+ with TypeScript
  • Build Tool: Vite
  • Styling: Tailwind CSS
  • UI Components: Shadcn UI
  • Animations: Framer Motion
  • Icons: Lucide React
  • Notifications: Sonner (Toast notifications)

πŸ“ Project Structure

src/
β”œβ”€β”€ components/
β”‚   β”œβ”€β”€ portfolio/
β”‚   β”‚   β”œβ”€β”€ About.tsx
β”‚   β”‚   β”œβ”€β”€ Certifications.tsx
β”‚   β”‚   β”œβ”€β”€ Contact.tsx
β”‚   β”‚   β”œβ”€β”€ Education.tsx
β”‚   β”‚   β”œβ”€β”€ Footer.tsx
β”‚   β”‚   β”œβ”€β”€ Hero.tsx
β”‚   β”‚   β”œβ”€β”€ HijabiAvatar.tsx
β”‚   β”‚   β”œβ”€β”€ Navbar.tsx
β”‚   β”‚   β”œβ”€β”€ OpenSource.tsx
β”‚   β”‚   β”œβ”€β”€ Projects.tsx
β”‚   β”‚   └── Skills.tsx
β”‚   └── ui/
β”‚       └── [Shadcn UI components]
β”œβ”€β”€ hooks/
β”‚   β”œβ”€β”€ use-mobile.tsx
β”‚   └── use-toast.ts
β”œβ”€β”€ lib/
β”‚   └── utils.ts
β”œβ”€β”€ pages/
β”‚   β”œβ”€β”€ Home.tsx
β”‚   └── not-found.tsx
β”œβ”€β”€ App.tsx
β”œβ”€β”€ main.tsx
└── index.css

πŸš€ Getting Started

Prerequisites

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

Installation

  1. Clone the repository:
git clone <repository-url>
cd portfolio
  1. Install dependencies:
npm install
  1. Start the development server:
npm run dev

The website will be available at http://localhost:5173

πŸ“¦ Available Scripts

  • npm run dev - Start development server
  • npm run build - Build for production
  • npm run preview - Preview production build
  • npm run lint - Run ESLint

🎨 Customization

Colors & Theme

Edit the theme colors in tailwind.config.js and theme provider to match your brand.

Content

Update the content in individual component files:

  • Hero: src/components/portfolio/Hero.tsx
  • About: src/components/portfolio/About.tsx
  • Skills: src/components/portfolio/Skills.tsx
  • Projects: src/components/portfolio/Projects.tsx
  • Education: src/components/portfolio/Education.tsx
  • Certifications: src/components/portfolio/Certifications.tsx
  • Open Source: src/components/portfolio/OpenSource.tsx
  • Contact: src/components/portfolio/Contact.tsx

πŸ“± Responsive Breakpoints

  • Mobile: < 640px
  • Tablet: 640px - 1024px
  • Desktop: > 1024px

πŸ”§ Configuration Files

  • vite.config.ts - Vite configuration
  • tailwind.config.js - Tailwind CSS configuration
  • tsconfig.json - TypeScript configuration
  • postcss.config.js - PostCSS configuration
  • components.json - Component configuration

🌐 Deployment

The website can be deployed to various platforms:

Vercel

npm install -g vercel
vercel

Netlify

npm run build
# Deploy the dist folder to Netlify

GitHub Pages

Build and push the dist folder to your GitHub Pages branch.

πŸ“ License

This project is licensed under the MIT License.

πŸ‘‹ Contact

For questions or feedback, feel free to reach out through the contact section on the website.


**Built with ❀️ by farheenayy**

About

🌟 Modern portfolio website showcasing projects, skills, and open source contributions. Built with React, TypeScript, Tailwind CSS & Framer Motion. Features smooth animations, responsive design, and dark mode support.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages