Skip to content

Brinsleym/website

Repository files navigation

Portfolio Site: brinsleymorrison.com

This repository contains the source code for my portfolio website.

website preview


MIT License     Hugo v0.149.0     JSDelivr

About

This site is forked from the Vonge Hugo Bookshop Template by CloudCannon. It has been significantly modified including the addition of:

Core Features

  • Full Multilingual Support & language switcher menu for English, Japanese and Chinese (Simplified) using i18n configs.
  • Hugo Bookshop Component System for modular, reusable content blocks

Audio Features

  • Custom SoundCloud Player with playlist functionality using SoundCloud API
    • Advanced error handling and detection of privacy-blocking extensions
    • iOS Safari audio playback policy compliance with automatic initialization
    • Custom background image support for enhanced visual presentation
    • Touch and mouse drag support for progress and volume controls
    • Visual feedback for volume controls and loading states
    • Accessibility features with proper ARIA labels
    • Privacy extension detection with user-friendly error messaging

Content Management & Structure

  • Portfolio Sections: Projects, compositions, and testimonials with rich media support
  • Contact Section: Replaced the original contact form section with a simpler 'copy email address' container
  • CV/Resume Embedding via browser iframe
  • Copy-to-Clipboard Email Functionality with clipboard API detection and fallback support
  • Bookshop Components: Blog cards, hero sections, testimonial cards, project cards, and more

Performance & User Experience

  • Asset Provisioning through JSDelivr's CDN for optimized global delivery
  • JavaScript Lazy Image Loading with Lightense image viewer integration
  • Image Optimization with WebP format and responsive sizing
  • Responsive Video Embeds using reframe.js
  • Smooth Scrolling with polyfill for cross-browser compatibility
  • Typewriter Effects using iTyped library for dynamic text displays

Server-side Features

  • Cloudflare DNS & Proxy with worker support to automatically detect user language and serve the relevant page
  • Snapshot Caching at archive.org, to show a recent snapshot of the page in the event of a server failure

Technical Improvements

  • Ionicons v7 with modern icon support
  • Advanced CSS/SCSS Structure with component-based styling
  • Tiny Slider Integration for responsive carousels and galleries
  • Mobile-Optimized Design with extensive CSS improvements for mobile devices
  • Hugo Build System with optimized static site generation

Development

Prerequisites

  • Hugo (v0.149.0 or later)
  • Git for version control

Local Development Setup

  1. Clone the repository:

    git clone https://github.com/Brinsleym/website.git
    cd website
  2. Start the development server:

    make dev

    (Or run hugo server --config config.dev.toml). This serves assets locally and enables hot reloading for development.

  3. Other Makefile commands:

    make deploy: (hugo --environment production --config config.toml)
    make clean: (rm -rf public/)
    make build: (clean deploy)

Build Process

The site uses Hugo's built-in build process:

  1. Hugo Build: Generates static site files
  2. Asset Processing: Optimizes CSS and JavaScript assets
  3. Static Generation: Creates production-ready site files

Technical Stack

Core Technologies

  • Hugo - Static site generator (v0.149.0)
  • Hugo Bookshop - Component-based content management

Frontend Libraries

Audio Integration

  • SoundCloud Widget API - Custom audio player implementation
  • Advanced Error Handling - Privacy extension detection and iOS compatibility

Performance & Optimization

  • JSDelivr CDN - Global asset delivery
  • WebP Image Format - Modern image optimization
  • Lazy Loading - Progressive image loading
  • CSS/SCSS Modules - Component-based styling

Deployment & Infrastructure

  • Cloudflare - DNS, proxy, and workers
  • Archive.org - Backup snapshots
  • Automated Builds - CI/CD integration

Site Metrics

Site Metrics

Future to-do

  • Enhance accessibility features with keyboard navigation improvements

License

Please refer to the original template's licensing terms for usage guidelines.

About

Source code for my portfolio site

Topics

Resources

License

Stars

Watchers

Forks

Contributors 3

  •  
  •  
  •