Artisan Developer is a static GitHub Pages portfolio theme built for developers, designers, students, freelancers, and creative technologists who want a portfolio that feels genuinely designed — not just functional. The theme ships with nine pre-built portfolio pages, ten interactive visual components, and a distinctive artisan identity drawn from tie-dye color work, marbled paper textures, and fluid dye-motion effects. Because the entire site is compiled to plain HTML, CSS, and JavaScript, there is no build step, no package manager, and no server to configure. You can open the files in any code editor, make your changes, and publish directly to GitHub Pages.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/apursley2012/artisan-developer/llms.txt
Use this file to discover all available pages before exploring further.
Design philosophy
Artisan Developer was designed around three guiding principles that keep the site expressive without sacrificing usability. Content first, decoration second. The visual system — tie-dye gradients, marbled backgrounds, kinetic headlines — was built to support the portfolio content, not compete with it. Decorative effects should never block navigation, obscure text, or make the site harder to scan. Page transitions stay short. Motion adds polish, but slow transitions make visitors wait. Every animated transition in the theme is intentionally brief so the site feels fluid without feeling heavy or sluggish. Consistent patterns across all pages. Navigation, cards, and headings follow the same structure on every page. That consistency means visitors can move through the site without having to re-learn the layout on each section — which is especially important for portfolios where the work itself should be the focus.What’s included
Nine portfolio pages
A complete set of HTML pages covering every common portfolio section: home, about, projects, skills, work history, case studies, blog, testimonials, and contact.
Ten visual components
Compiled JavaScript components including SwirlNav, DyeCursor, KineticHeadline, MarbledCard, FabricStripTimeline, TieDyeSwirl, PaintTube, SoapBubble, ColorWheel, and PageTransition.
Custom CSS utilities
Hand-crafted utility classes —
.tie-dye-bg, .marbled-paper, .soap-bubble, .dye-bleed-input, and .tie-dye-text — that bring the artisan visual identity into the stylesheet.GitHub Pages compatible
A
.nojekyll file, relative asset paths, and a root-level index.html entry point ensure the theme works with GitHub Pages out of the box, with no server-side configuration needed.Who it’s for
Artisan Developer is designed for anyone who wants a portfolio with a stronger visual identity than a plain starter template. That includes developers showcasing side projects and open-source work, students building their first public portfolio, designers who want a site that reflects their aesthetic sensibility, writers and creative technologists who need a writing or case study archive, and freelancers who want a single place that covers their work history, contact details, and testimonials. The theme is also approachable for beginners. Because the site is already static, you do not need to run a local server, install a database, or understand a deployment pipeline before publishing it. If you can edit an HTML file in a text editor, you can customize this theme.Technology stack
The following libraries and tools power Artisan Developer. They are already compiled into the static files in theassets/ and components/ folders — you do not need to install any of them.
| Technology | Version | Role |
|---|---|---|
| React | 18 | Component rendering and UI state |
| React Router | 6 | Client-side routing between pages |
| Framer Motion | Latest compiled | Page transitions and motion effects |
| Tailwind CSS | Latest compiled | Utility-first layout and styling |
| Lucide React | Latest compiled | Icon set used across the UI |
The source for this theme is compiled to static ES modules. There is no
npm install, no build command, and no bundler to configure. The files inside assets/ and components/ are ready to use as-is — just upload them to your repository alongside index.html and the pages/ folder.