Web Dev Portfolio

🌐 Live Site: alexsantos.dev

A modern, full-stack personal portfolio and blog built with SvelteKit. This project showcases my web development skills and serves as a platform for sharing insights and experiences in software development.

✨ Features

• Modern SvelteKit Frontend - Fast, reactive UI with server-side rendering
• Dynamic Configuration - Centralized site settings managed through CMS
• Content Management - Blog posts with markdown support and frontmatter
• Dark/Light Theme - Automatic system preference detection with manual toggle
• Admin Interface - Sveltia CMS integration for content and settings management
• OAuth Authentication - GitHub OAuth for secure admin access
• Social Media Integration - Dynamic social links with brand icons
• Image Processing - Dynamic image optimization with Sharp
• Responsive Design - Mobile-first approach with Tailwind CSS
• Type Safety - Full TypeScript implementation
• Testing Suite - Unit and E2E testing with Vitest and Playwright
• CI/CD Pipeline - Automated deployment with GitHub Actions

🛠️ Tech Stack

Frontend

• SvelteKit - Meta-framework for building web applications
• Svelte 5 - Component-based UI framework
• TypeScript - Type-safe JavaScript
• Tailwind CSS - Utility-first CSS framework
• Lucide Svelte - Beautiful SVG icons
• @icons-pack/svelte-simple-icons - Brand icons for social media

Backend & Content

• Node.js - Server runtime

Content Management

• Sveltia CMS - Git-based headless CMS
• Gray Matter - Frontmatter parser
• Marked - Markdown parser and compiler

Image Processing

• Sharp - High-performance image processing

Authentication & OAuth

• Simple OAuth2 - OAuth 2.0 client
• GitHub OAuth - Secure authentication for admin access

Development & Testing

• Vite - Build tool and dev server
• Vitest - Unit testing framework
• Playwright - End-to-end testing
• ESLint - JavaScript/TypeScript linting
• Prettier - Code formatting

Deployment & Infrastructure

• GitHub Actions - CI/CD pipeline
• Coolify - Self-hosted deployment platform
• Docker - Containerization

🚀 Getting Started

Prerequisites

• Node.js 18.18.0 or higher
• npm or your preferred package manager

Installation

1. Clone the repository:

   git clone https://github.com/asantoss/web-dev-portfolio.git
   cd web-dev-portfolio

2. Install dependencies:

   npm install

3. Set up environment variables:

   cp .env.example .env

   Configure the following variables:

   GITHUB_CLIENT_ID=your_github_oauth_client_id
   GITHUB_CLIENT_SECRET=your_github_oauth_client_secret

4. Configure your site settings:

   The site configuration is stored in src/config/site.json. You can either:

   • Edit this file directly with your personal information
   • Use the admin interface at /admin after setting up OAuth

5. Run the development server:

   npm run dev

6. Open http://localhost:5173 in your browser.

📝 Content Management

Site Configuration

All personal information, social links, skills, and site metadata are managed through a centralized configuration system:

• Personal Information: Name, title, email, profile image
• Bio Content: Rich markdown content with automatic rendering
• Social Links: GitHub, LinkedIn, Twitter/X, Bluesky, website, email
• Skills & Technologies: Dynamic skill showcase with custom icons
• Site Metadata: SEO-friendly titles, descriptions, and copyright info

Configuration is stored in src/config/site.json and can be edited through the Sveltia CMS admin interface.

Creating Posts

Posts are stored as Markdown files in src/posts/ with frontmatter:

---
title: Your Post Title
description: A brief description
image: /images/your-image.png
draft: false
tags: ["web-development", "svelte"]
date: 2025-05-28T09:21:00
---

Your markdown content here...

Admin Interface

Access the admin panel at /admin to manage content and site settings through the Sveltia CMS interface. Authentication is handled via GitHub OAuth.

Available Admin Sections:

• Posts: Create, edit, and manage blog posts
• Site Settings: Update personal information, bio, social links, skills, and metadata

🛠️ Available Scripts

# Development
npm run dev              # Start development server
npm run build            # Build for production
npm run preview          # Preview production build

# Code Quality
npm run lint             # Run ESLint
npm run format           # Format code with Prettier
npm run check            # Type checking with svelte-check

# Testing
npm run test             # Run all tests
npm run test:unit        # Run unit tests
npm run test:e2e         # Run end-to-end tests

🏗️ Project Structure

src/
├── app.html              # HTML template
├── app.css               # Global styles
├── components/           # Reusable components
├── config/               # Site configuration
│   └── site.json        # Centralized site settings
├── lib/
│   ├── icons/           # SVG icon components
│   ├── server/          # Server-side utilities
│   │   ├── config.ts    # Configuration loader
│   │   └── queries.ts   # Data fetching utilities
│   └── stores/          # Svelte stores
├── posts/               # Markdown blog posts
├── routes/              # SvelteKit routes
└── types/               # TypeScript type definitions
    └── config.d.ts      # Configuration type definitions

🎨 Customization

Personalizing Your Portfolio

1. Update Site Configuration: Edit src/config/site.json or use the admin interface at /admin
2. Add Your Profile Image: Place your profile image in the static/ directory
3. Configure Social Links: Add your social media profiles in the site settings
4. Customize Skills: Update the skills section with your technologies and tools
5. Write Your Bio: Craft your personal bio using Markdown for rich formatting

Adding New Skills

Skills are dynamically rendered based on your configuration. To add a new skill:

1. Add the skill to your site.json configuration
2. Create an icon component in src/lib/icons/ if needed
3. Update the icon mapping in the Skills component

Theme Customization

The site supports both light and dark themes with automatic system preference detection. Customize colors in src/app.css using Tailwind's theme configuration.

🚀 Deployment

The project is configured for deployment with:

1. GitHub Actions - Automated CI/CD pipeline
2. Coolify - Self-hosted deployment platform
3. Docker - Containerized deployment

The deployment process:

1. Push to main branch triggers GitHub Action
2. Action builds and pushes Docker image
3. Coolify deploys the updated container

Configuration Management

Site configuration changes made through the CMS are automatically committed to your repository, triggering a new deployment. This ensures your changes are version-controlled and deployed consistently.

🤝 Contributing

This is a personal portfolio project, but I welcome suggestions and feedback! Feel free to:

1. Open an issue for bug reports or feature requests
2. Submit a pull request for improvements
3. Share feedback on the live site

📄 License

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

👨‍💻 About

Built with ❤️ by Alexander Santos - a passionate software consultant specializing in modern web development, Salesforce solutions, and creative problem-solving.

Connect with me:

• 🌐 alexsantos.dev
• 📧 [email protected]
• 💼 LinkedIn
• 🐙 GitHub