{
    "id": "bhaskar/pavement-poster-portfolio",
    "kind": "plan",
    "title": "Pavement poster portfolio",
    "summary": "A print studio portfolio where posters lie on a night street, the wind lifts each one as you walk past, and any poster can be picked up to read its print specs.",
    "author": "Admin",
    "stars": 0,
    "url": "https://ownlyplans.com/bhaskar/pavement-poster-portfolio/",
    "stack": [
        "CSS",
        "GLSL",
        "GSAP",
        "HTML",
        "JavaScript",
        "Three.js"
    ],
    "tools": [
        "claude-code",
        "cursor",
        "lovable"
    ],
    "difficulty": "advanced",
    "license": "all-rights",
    "version": "1.0",
    "overview": "A single-file 3D portfolio hero for a poster studio, built with Three.js and GSAP. You look straight down at a street at night: a warm streetlamp pool, blind-slat shadows on one side and leaf shadows that drift in the light. Ten posters lie on the ground, each on its own surface (concrete slabs, asphalt, a zebra crossing, small tiles, a road with a lane line). Scrolling walks you down the street one poster at a time: the poster you pass lifts, curls and blows away while the next one settles, and the title, counter and side index follow. Click a poster to pick it up: it flies up flat beside a panel with format, print method, run, paper, Request a print and Next poster. It also has an Index panel, a Contact popover, a day mode that swaps the lamp for sunlight, a chalk \"your poster here\" ending with Start a project, and a phone layout. All poster artwork is drawn on canvas in the file; the demo studio is Gully Press in Vizag with free Unsplash photos.",
    "steps": [
        {
            "title": "Lay the street and the lamp",
            "body": "Build one long procedural street in a fragment shader, with a different surface under each poster and night lighting from a streetlamp.",
            "prompt": "Create a single-file HTML portfolio hero for a poster studio called \"Gully Press\". Load Three.js 0.160 and GSAP 3.12 from jsDelivr through an import map. Full-screen WebGL canvas, perspective camera (fov 32) looking straight down at the XY plane, one poster every 9 units along +Y. Make the ground one long plane with a ShaderMaterial. In GLSL write hash, value noise and 5-octave fbm, then five surfaces: concrete slabs (3.4-unit joints, grain, rare thin cracks), asphalt (speckles), a worn zebra crossing, small tiles with grout, and a road with a broken yellow lane line. Pick the surface per segment from a uniform float array and draw a kerb where two surfaces meet. Light everything with a shared lightAt(): a dark ambient plus a warm lamp pool fixed in screen space, diagonal blind-slat shadows on the left edge, optional animated leaf shadows (thresholded fbm) and a vignette. A uDay uniform blends to bright, cool daylight.",
            "done": "The street shows five different surfaces in a warm lamp pool with slat shadows on the left.",
            "files": []
        },
        {
            "title": "Paint the posters and drop them on the ground",
            "body": "Draw ten original posters on canvas, map them onto curling planes lit by the same street light, and give each one a soft shadow.",
            "prompt": "Keep a P array of 10 posters (name, kind, client, year, colour dot, ground type, leaf flag, design id, format, print, run, paper, description). Paint each design on a 1024x1448 canvas with Familjen Grotesk, Instrument Serif, Anton and DM Mono: a quiet serif reading series, a one-colour red riso exhibition, a green night-bus poster with a duotone photo, a letterpress monogram, a pile of small launch flyers, a festival poster with an orange circle, a pink and blue halftone zine fair, a gold-on-black cinema poster, a fluorescent night run and a museum poster with a framed photo. Add faint paper grain. Put each texture on a 3 x 4.24 plane with a ShaderMaterial whose vertex shader curls the top and one edge (uCurl) and ripples it (uWave), and whose fragment shader uses the same lightAt() as the ground. Under each poster place a blurred black shadow plane that moves away (x + L*0.32, y - L*0.5) and fades as the poster lifts. Scatter nine copies for the flyer pile.",
            "done": "Ten different posters lie on the street, lit by the lamp, each with a soft shadow.",
            "files": []
        },
        {
            "title": "Walk the street: wind, snap and the HUD",
            "body": "Map scroll to walking, blow away the poster you pass, settle the next one, and keep the title, counter and side index in sync.",
            "prompt": "Make the page tall enough for one scroll step (70% of the viewport, min 420px) per poster plus one for the end. Ease a live position p toward the scroll target every frame and snap to the nearest whole poster 170ms after scrolling stops. Move the camera to y = p * 9. For poster i use d = p - i: when d > 0 the wind takes it (lift up to 2.6, move it down the street faster than you, rotate, curl with sin(d * PI), fade out from d = 0.3); when d is between -1.3 and 0 it is still settling (lifted a little, slightly turned). Bottom left, show a rolling 01 / 10 counter, the poster name in big bold type (blur out and back in on change), a coloured square with kind, client and year, and a \"Scroll to walk the street · click a poster to pick it up\" hint. On the right, a column of short ticks: the active one is long with its name, and hovering the column shows all names. Clicking a tick jumps to that poster.",
            "done": "Each scroll step blows the last poster away and settles the next, and the title and side index follow.",
            "files": []
        },
        {
            "title": "Pick up a poster, day mode and the ending",
            "body": "Raycast the posters, lift the clicked one into a detail view, add day and night, the Index and Contact panels, a chalk ending and the phone layout.",
            "prompt": "Raycast the posters on pointer move; on hover lift the poster slightly and show a pill with its name and \"Pick up\". On click, lock scrolling, fade a dark plane over the street, and fly the poster to a box on the left (measure the DOM box and convert it to world space at z = 6.5), flattening its curl and turning it straight. On the right, stagger in kind and year, the name, \"For client\", a description, Format, Print, Run and Paper rows, a Request a print button and a Next poster link. A round X or Escape puts it back. Top bar: logo and \"Posters & printed matter, Vizag\" on the left; a moon/sun button that tweens uDay, an \"Index 10\" pill (left glass list of all posters) and a Contact pill (popover with email, copy button and links). After the last poster, show a chalk outline with \"your poster here\" on the pavement and swap the title for \"Start a project.\" with Commission a poster and Back to 01. Under 860px use a wider field of view, fit the poster to 62% of the width and stack the detail view.",
            "done": "Posters can be picked up and put back, day mode works, and the street ends on the chalk outline with Start a project.",
            "files": [
                "pavement-posters.html"
            ]
        }
    ],
    "files": [
        {
            "type": "markdown",
            "name": "pavement-posters.html",
            "note": "The finished file. Open it in a browser. Edit posters in P and the 7 photo URLs in PHOTOS; all poster art is drawn in DESIGNS.",
            "file": "pavement-posters",
            "url": "https://ownlyplans.com/bhaskar/pavement-poster-portfolio/pavement-posters/"
        }
    ],
    "install": "",
    "how_to_use": "Call get_step with step 1, do it, check \"done when\", then continue."
}