Skip to content

Repository files navigation

Logo

React Developer Portfolio

A modern, fast, and fully responsive personal portfolio — built to showcase your work, skills, and story with a premium, polished feel.

React Vite Tailwind CSS shadcn/ui

PRs Welcome Maintained

Preview · Features · Tech Stack · Getting Started · Deployment · Contact


🖼️ Preview

Portfolio homepage preview

📖 Overview

This portfolio is built for a clean, modern online presence. It's powered by React 19 and Vite for near-instant load times, and styled with Tailwind CSS v4 and shadcn/ui for a sleek, premium interface. Every section is modular and fully responsive, so it looks great from a small phone screen to a large desktop monitor.


✨ Features

Feature Description
🎨 Modern UI/UX A stunning, premium design following modern web design principles
Blazing Fast Powered by Vite + React 19 for instant load times and smooth rendering
🧩 Component-Driven Built with clean, reusable, and modular React components
🎞️ Smooth Animations Subtle micro-animations via tw-animate-css and custom transitions
🔁 Interactive Elements Continuous marquees (react-fast-marquee) and dynamic UI touches
🧭 Client-Side Routing Smooth navigation between pages with react-router-dom

🛠 Tech Stack

Core

Tool Purpose
React 19 UI library
Vite Frontend tooling & bundler
React Router Client-side navigation

Styling & UI

Tool Purpose
Tailwind CSS v4 Utility-first CSS framework
shadcn/ui Beautifully designed, accessible components
Base UI Unstyled, accessible React primitives

Icons & Typography

Tool Purpose
Lucide React Consistent, lightweight icon set
FontAwesome Vector icons & social logos
Remix Icon Neutral-style system icons
Inter Modern sans-serif typeface

📂 Project Structure

├── public/               # Static assets (favicon, preview.png, etc.)
├── src/
│   ├── assets/           # Images, fonts, and local media
│   ├── components/       # Reusable UI components (Menu, Profile, etc.)
│   │   ├── body/         # Main page sections (Home, etc.)
│   │   └── ui/           # Generic UI elements (shadcn/ui)
│   ├── lib/              # Utility functions
│   ├── Projects/         # Project showcase components
│   ├── App.jsx           # Root layout component
│   ├── AppRoutes.jsx     # Routing configuration
│   ├── index.css         # Global styles and Tailwind configuration
│   └── main.jsx          # Application entry point
├── package.json          # Project dependencies and scripts
└── vite.config.js        # Vite configuration

💻 Getting Started

Follow these steps to get a local copy up and running.

Prerequisites

  • Node.js v18 or newer
  • npm or yarn

Installation

# 1. Clone the repository
git clone https://github.com/DevMahida/React-Portfolio.git

# 2. Move into the project directory
cd React-Portfolio

# 3. Install dependencies
npm install

# 4. Start the development server
npm run dev

Then open your browser at http://localhost:5173 🎉


🏗 Available Scripts

Command Description
npm run dev Starts the Vite development server
npm run build Bundles the app into static files for production
npm run preview Serves the production build locally for testing
npm run lint Runs ESLint to catch code quality/style issues

🎨 Customization

Make it yours in a few steps:

  1. Your info — update src/components/Profile.jsx and related body components with your name, bio, skills, and resume.
  2. Your projects — add entries in the src/Projects directory.
  3. Your colors — tweak the theme in src/index.css / Tailwind config.
  4. Your images — swap out placeholder images in src/assets.
  5. Your screenshot — don't forget the preview image at the top of this README once your site is ready!

☁️ Deployment

Deployment is currently pending and will be completed in the future. Once deployed, the live link will be added here!


📬 Contact


Built with ❤️ using React & Vite.

About

No description or website provided.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages