Skip to content

README.md

Latest commit

 

History

History
77 lines (54 loc) · 1.88 KB

README.md

File metadata and controls

77 lines (54 loc) · 1.88 KB

Marco Pisco Website

Personal website source for marcopisco.com, built with TypeScript + Vite and deployed with GitHub Pages.

GitHub last commit GitHub code size in bytes GitHub language count

Tech Stack

  • TypeScript
  • Vite
  • Vanilla HTML/CSS
  • GitHub Actions + GitHub Pages
  • Lanyard WebSocket API (Discord live presence)

Features

  • Single-page portfolio layout (hero, about, tech stack, experience, education, contact)
  • Live Discord presence cards using Lanyard WebSocket
  • Posts section backed by local Markdown files
  • Smooth reveal and hover animations
  • Responsive layout for desktop and mobile

Local Development

bun install
bun run dev

Default dev URL: http://localhost:5173

Build and Preview

bun run typecheck
bun run build
bun run preview

The production build is generated in dist/.

Posts Workflow

Posts are loaded from the public/writeups directory:

  • public/writeups/index.json contains metadata for each post
  • public/writeups/<slug>.md contains the Markdown content

Example index.json item:

{
  "slug": "example-post",
  "title": "Example Post",
  "date": "2026-01-15",
  "summary": "Short summary.",
  "tags": ["tag1", "tag2"]
}

Deployment

Deployment is fully automated by .github/workflows/deploy-pages.yml:

  1. Trigger on push to main
  2. Install dependencies with bun ci
  3. Build with bun run build
  4. Upload dist/ artifact
  5. Deploy to GitHub Pages

Custom domain is configured via CNAME (marcopisco.com).

License

This project is licensed under the GNU General Public License v3.0. See LICENSE.