Get Started: Run the Portfolio Locally

Before you begin, make sure you have the following installed on your machine:

Clone the repository

Clone the project from GitHub and navigate into the directory.

git clone https://github.com/JuanRojasDev/juan-rojas-portafolio-web.git
cd juan-rojas-portafolio-web

Install dependencies

Install all required npm packages. This includes React, MUI, Three.js, Framer Motion, and the rest of the dependency tree.

npm install

This will take a minute or two on a fresh clone.

Configure environment variables

The contact form uses EmailJS to send messages without a backend. Create a .env file in the project root and add your EmailJS credentials:

REACT_APP_EMAILJS_SERVICE_ID=your_service_id
REACT_APP_EMAILJS_TEMPLATE_ID=your_template_id
REACT_APP_EMAILJS_PUBLIC_KEY=your_public_key

The contact form will not function without valid EmailJS credentials. All other sections of the portfolio work without this step.

Start the development server

Run the local development server. The app will open at http://localhost:3000 and reload automatically on file changes.

npm start

Available scripts

Command	Description
`npm start`	Starts the development server at `localhost:3000`
`npm run build`	Creates an optimized production build in the `build/` directory
`npm test`	Runs the test suite in interactive watch mode
`npm run deploy`	Builds and deploys to GitHub Pages (requires `gh-pages` setup)

After getting the project running locally, see Codebase Structure to understand how the files are organized.