Skip to main content

Build stunning portfolio websites with automated integrations

Learn how to create immersive artist portfolios with real-time API integration for Spotify, SoundCloud, and YouTube. Built with Astro and TypeScript.

Get StartedView Documentation

Quick Start

Get your portfolio up and running in minutes

1

Clone and install dependencies

Clone the repository and install all required packages using your preferred package manager.
git clone https://github.com/mrcl29/jowy-portfolio.git
cd jowy-portfolio
pnpm install
2

Configure environment variables

Set up your API credentials for Spotify, SoundCloud, and YouTube integrations.
cp .env.example .env
# Edit .env with your API keys
You’ll need API credentials from Spotify, SoundCloud, and YouTube. See the API Setup guide for details.
3

Start the development server

Launch the Astro development server and view your portfolio locally.
pnpm dev
Visit http://localhost:4321 to see your portfolio in action.

Explore by Topic

Deep dive into the core features and capabilities

Architecture Overview

Understand the project structure and how components work together

API Integration

Learn about the BaseFetcher abstraction and service layer

Components Library

Explore reusable UI and media components

Internationalization

Set up multi-language support for your portfolio

Key Features

Everything you need to build a professional portfolio

Multi-API Integration

Spotify, SoundCloud, and YouTube APIs with server-side caching

Dark Mode First

Custom neon aesthetics with gradient masks and animations

TypeScript & Astro

Strongly typed with modern framework architecture

Automated CI/CD

Weekly rebuilds to keep content fresh automatically

Server Caching

Optimized API calls with in-memory caching system

Responsive Design

TailwindCSS with DaisyUI for beautiful, adaptive layouts

Ready to build your portfolio?

Follow our comprehensive guides to create an immersive portfolio website with automated content updates.

Start Building