Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
93 changes: 12 additions & 81 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,86 +1,17 @@
# Personal Portfolio Website
# Samuel Hernandez Balderas

A responsive personal portfolio website featuring interactive 3D graphics and a Canvas 2D background implementation to
showcase engineering projects, skills, and professional experience.
This is the repository for my personal portfolio website, where I present my
software engineering projects, experience, and background.

This repository automatically deploys to GitHub Pages via a shared CI workflow.
If you find this project interesting, feel free to leave a star on the
repository.

## Features
## Copyright and distribution

- **3D Graphics** - Interactive Three.js models (hero desktop PC, Earth)
- **Canvas Background** - Custom 2D dots-and-lines network rendering
- **Responsive Layout** - Mobile-first CSS optimizations
- **Project Showcase** - Componentized project cards with direct repository routing
- **Experience Accordion** - Expandable timeline components for professional experience
- **Tech Stack Display** - Visual architecture diagrams and skill representations
- **Contact Form** - Integrated EmailJS processing
Copyright (c) 2026 Samuel Hernandez Balderas. All rights reserved.

## Tech Stack

### Frontend

- **React 18.3**
- **Vite**
- **Tailwind CSS**
- **PostCSS**

### 3D & Graphics

- **Three.js**
- **@react-three/fiber**
- **@react-three/drei**

### Animation & Interaction

- **Framer Motion**
- **React Tilt**
- **React Vertical Timeline Component**

## Getting Started

### 1. Clone the Repository

```bash
git clone <https://github.com/SamuelIVX/SamuelIVX.github.io.git>
cd SamuelIVX.github.io
```

### 2. Install Dependencies

```bash
npm install
```

### 3. Environment Setup

Create a `.env` file in the root directory for EmailJS integration:

```env
VITE_APP_EMAILJS_SERVICE_ID=your_service_id
VITE_APP_EMAILJS_TEMPLATE_ID=your_template_id
VITE_APP_EMAILJS_PUBLIC_KEY=your_public_key
```

### 4. Run Development Server

```bash
npm run dev
```

Open [<http://localhost:5173](http://localhost:5173)> in your browser.

## Deployment

This repository is configured with a GitHub Actions workflow template that automatically builds the Vite application and
deploys the `dist/` output to GitHub Pages on every push to `main`.

The user's resume is hosted statically in the `public/resume.pdf` directory and served natively alongside the
application.

## Approved portfolio revamp specifications

The live application above remains the current implementation. The approved redesign is specified in [Portfolio revamp
spec set](docs/specs/active/portfolio-revamp/README.md), with seven ordered specifications, [implementation plan and
installed skill register](docs/specs/active/portfolio-revamp/IMPLEMENTATION-PLAN.md), and a [durable prototype
reference](docs/specs/reference/portfolio-revamp/README.md). Performance/security gates are planned, not achieved
production results. This spec-writing change does not deploy the redesign.
The original code and content written for this website are distributed under the
MIT License. Certain UI elements incorporate third-party open-source components,
including canvas background routines adapted from React Bits under the MIT +
Commons Clause License. For complete terms and third-party notices, refer to
[THIRD-PARTY-NOTICES.md](THIRD-PARTY-NOTICES.md).
4 changes: 2 additions & 2 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<html lang="en" data-theme="dark">
<head>
<meta charset="UTF-8" />
<link rel="icon" type="image/svg+xml" href="/logo.svg" />
<link rel="icon" type="image/jpeg" href="/logo.jpg" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta http-equiv="Content-Security-Policy" content="default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; font-src 'self'; connect-src 'self';" />

Expand All @@ -23,7 +23,7 @@
<meta property="og:description" content="Software Engineer specializing in scalable solutions, process optimization, and data-driven development. Explore projects, skills, and experience." />
<meta property="og:type" content="website" />
<meta property="og:url" content="https://samuelivx.github.io/" />
<meta property="og:image" content="/logo.svg" />
<meta property="og:image" content="/logo.jpg" />
<meta name="twitter:card" content="summary" />
<meta name="twitter:title" content="Samuel Hernandez Balderas | Software Engineer" />
<meta name="twitter:description" content="Software Engineer specializing in scalable solutions, process optimization, and data-driven development." />
Expand Down
Binary file added public/assets/resume.pdf
Binary file not shown.
Binary file added public/logo.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
6 changes: 0 additions & 6 deletions public/logo.svg

This file was deleted.

Binary file added public/projects/clarify.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/projects/foodsense.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/projects/interleave.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/projects/paycore.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 0 additions & 3 deletions src/assets/close.svg

This file was deleted.

Binary file removed src/assets/company/amazonwebservices.jpeg
Binary file not shown.
Binary file removed src/assets/company/aot.jpeg
Binary file not shown.
Binary file removed src/assets/github.png
Binary file not shown.
Binary file removed src/assets/hero/herobg.png
Binary file not shown.
89 changes: 0 additions & 89 deletions src/assets/index.js

This file was deleted.

Binary file removed src/assets/logo.png
Binary file not shown.
3 changes: 0 additions & 3 deletions src/assets/menu.svg

This file was deleted.

Binary file removed src/assets/projects/carwash.png
Binary file not shown.
Binary file removed src/assets/projects/clarify.png
Binary file not shown.
Binary file removed src/assets/projects/deltabase.png
Binary file not shown.
Binary file removed src/assets/projects/ecommerce.png
Binary file not shown.
Binary file removed src/assets/projects/foodsense.png
Binary file not shown.
Binary file removed src/assets/projects/paycore.png
Binary file not shown.
Binary file removed src/assets/tech/aws.jpeg
Binary file not shown.
Binary file removed src/assets/tech/c++.png
Binary file not shown.
Binary file removed src/assets/tech/css.png
Binary file not shown.
Binary file removed src/assets/tech/docker.png
Binary file not shown.
Binary file removed src/assets/tech/figma.png
Binary file not shown.
Binary file removed src/assets/tech/git.png
Binary file not shown.
Binary file removed src/assets/tech/html.png
Diff not rendered.
Binary file removed src/assets/tech/java.webp
Diff not rendered.
Binary file removed src/assets/tech/javascript.png
Diff not rendered.
4 changes: 0 additions & 4 deletions src/assets/tech/maven.svg
Diff not rendered.
5 changes: 0 additions & 5 deletions src/assets/tech/motion.svg
Diff not rendered.
Binary file removed src/assets/tech/mysql.png
Diff not rendered.
4 changes: 0 additions & 4 deletions src/assets/tech/nextjs.svg
Diff not rendered.
Binary file removed src/assets/tech/nodejs.png
Diff not rendered.
4 changes: 0 additions & 4 deletions src/assets/tech/postgresql.svg
Diff not rendered.
2 changes: 0 additions & 2 deletions src/assets/tech/python.svg
Diff not rendered.
Binary file removed src/assets/tech/reactjs.png
Diff not rendered.
Loading
Loading