More room for your next idea. Membership from $9.99/month.Take a look
All guides
Guide

Write a Portfolio Case Study with Decisions and Source Evidence

Explain your role, constraints and decisions, distinguish observed metrics from targets, then build and review a complete static portfolio with a local contact draft.

Fastest way

Ask your AI to do it

Paste this into the AI agent you already use:

Use Portfolio Case Study Studio to present my approved work with accurate roles, constraints, decisions and source-linked outcomes. Separate observed, target and fictional metrics; distinguish illustrative studies from real screenshots. Inspect all pages and local contact drafts, then review domain SEO and permissions before a separate publication.

What makes a portfolio case study more useful than a gallery?

A case explains the problem, your actual contribution, the choices and the evidence behind the outcome. Portfolio Case Study Studio v1.0.0 turns approved structured cases into a static home, work index, individual case pages, profile and contact-draft flow. Python 3.10+ runs its generator offline without dependencies or an image-service key.

Choose publishable evidence before authoring the story

  • Read references/input.md. Supply the audience, role, period, challenge, constraints, approach, decisions and learning. Identify your contribution accurately and retain permission, method, period and sample limits in source notes.
  • Keep observed, target and fictional sources distinct. Percentage changes use percentage points; other units use relative change, which is undefined from a zero baseline. A descriptive before/after change does not establish causality.
  • Remove confidential material before input. publishApproved is a review assertion, not a rights audit. The generator creates illustrative SVG interface studies, not customer screenshots; approved real screenshots require a deliberate page adaptation.

Generate a complete fictional portfolio

After installing and reviewing the package, run from its directory into a fresh folder. Nia Rowan and the included projects are fictional. Open practice-portfolio/index.html or serve the folder locally. Replace all fictional identity and source claims, set fictional to false and omit --demo for approved real work.

python3 scripts/build-portfolio.py --input examples/portfolio.json --demo --output ./practice-portfolio

Check every case and the contact draft

  • Open home, work, every case, about, contact and 404. Check category/search empty results, theme continuity, illustrations, keyboard controls and comparison sliders at phone width. View filters must not remove exported cases.
  • On Contact, test missing fields, prepare a valid draft and inspect its downloaded text. Changing an input must invalidate the old draft. The form sends no message and has no delivery service.
  • Compare each metric with its source record and exported CSV. Inspect editable JSON, case briefs, quality notes, the publication checklist and SHA-256 manifest. A polished comparison is not measured uplift.

Review publication settings for the actual domain

The examples intentionally use noindex. Complete the supplied permission and domain-specific SEO checklist before publishing real work; configure the host to use 404.html for errors. Generating files does not deploy a site, send a contact request or prove search indexing. Keep private sources private, and recheck canonical and robots on the final public pages.

All guides