Skip to content

ethelynmatias/portfolio

Repository files navigation

Portfolio Website

A modern, responsive portfolio website built with React, Vite, and Tailwind CSS. Features smooth animations, typewriter effects, and a clean professional design.

πŸš€ Live Demo

View Portfolio

✨ Features

  • Responsive Design: Fully responsive layout that works on all devices
  • Smooth Animations: Typewriter effect for intro text and scroll animations
  • Modern UI: Clean, professional design with gradient effects
  • Skills Section: Visual progress bars for technical skills
  • Services Showcase: Detailed service offerings with icons
  • Education & Experience Timeline: Professional background display
  • Contact Section: Social media links (GitHub, LinkedIn)
  • Fast Performance: Built with Vite for optimal loading speeds

πŸ› οΈ Tech Stack

  • Frontend Framework: React 18
  • Build Tool: Vite
  • Styling: Tailwind CSS v4
  • Icons: Lucide React
  • Animations: Custom CSS animations
  • JavaScript: ES6+

πŸ“‹ Prerequisites

Before you begin, ensure you have the following installed:

  • Node.js (version 14 or higher)
  • npm (comes with Node.js) or yarn
  • Git (for cloning the repository)

πŸ”§ Installation & Setup

1. Clone the Repository

git clone https://github.com/ethelynmatias/portfolio.git
cd portfolio

2. Install Dependencies

npm install

Or if you prefer yarn:

yarn install

3. Run Development Server

npm run dev

Or with yarn:

yarn dev

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

πŸ“¦ Building for Production

1. Create Production Build

npm run build

Or with yarn:

yarn build

This will create a dist folder with optimized production files.

2. Preview Production Build

npm run preview

Or with yarn:

yarn preview

3. Serve Production Build

You can serve the production build using:

npx serve dist -p 3000

The production site will be available at http://localhost:3000

πŸš€ Deployment

Deploy to GitHub Pages

  1. Install gh-pages:
npm install --save-dev gh-pages
  1. Add to package.json scripts:
"predeploy": "npm run build",
"deploy": "gh-pages -d dist"
  1. Deploy:
npm run deploy

Deploy to Netlify

  1. Build the project:
npm run build
  1. Drag and drop the dist folder to Netlify

Deploy to Vercel

  1. Install Vercel CLI:
npm install -g vercel
  1. Deploy:
vercel

πŸ“ Project Structure

portfolio/
β”œβ”€β”€ public/              # Static assets
β”‚   └── images/         # Image files
β”œβ”€β”€ src/                # Source files
β”‚   β”œβ”€β”€ components/     # React components
β”‚   β”œβ”€β”€ CVPortfolio.jsx # Main portfolio component
β”‚   β”œβ”€β”€ index.css       # Global styles and animations
β”‚   └── main.jsx        # Application entry point
β”œβ”€β”€ .gitignore          # Git ignore file
β”œβ”€β”€ index.html          # HTML template
β”œβ”€β”€ package.json        # Project dependencies
β”œβ”€β”€ postcss.config.js   # PostCSS configuration
β”œβ”€β”€ tailwind.config.js  # Tailwind CSS configuration
β”œβ”€β”€ vite.config.js      # Vite configuration
└── README.md           # Project documentation

🎨 Customization

Update Personal Information

Edit src/CVPortfolio.jsx to update:

  • Name and title
  • About section content
  • Skills and percentages
  • Education and experience
  • Contact information
  • Social media links

Change Colors/Theme

Modify the color scheme in:

  • src/CVPortfolio.jsx (inline styles)
  • src/index.css (global styles)
  • tailwind.config.js (Tailwind configuration)

Add Portfolio Items

In src/CVPortfolio.jsx, update the portfolioItems array:

const portfolioItems = [
  {
    id: 1,
    title: "Project Name",
    category: "web",
    image: "/images/project.jpg",
    description: "Project description"
  },
  // Add more items...
];

πŸ§ͺ 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

πŸ› Troubleshooting

Port Already in Use

If port 5173 is already in use, you can specify a different port:

npm run dev -- --port 3000

Dependencies Issues

Clear cache and reinstall:

rm -rf node_modules package-lock.json
npm install

Build Errors

Check Node.js version:

node --version

Ensure it's version 14 or higher.

πŸ“ License

This project is open source and available under the MIT License.

🀝 Contributing

Contributions, issues, and feature requests are welcome!

πŸ‘€ Contact


Made with ❀️ using React + Vite

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors