Overview
Every drawing lands on its photograph. Your plan rises into a white card model, the camera stands exactly where your photographer stood, and the real photograph locks into the model: the model's walls run straight into the walls in the photo, and the room's name and size stay lying on its floor. Then each project prints as a one-page sheet.
What's in the box
- A one-page Next.js site (Next 15, React 19) and a static-HTML copy of it (
npm run build:html). - One data file:
src/data/studio.ts— your studio, people, phases, projects, plans and photographs. - The pin tool (
/pinwhilenpm run devruns): trace your plan's walls from an image of it (about 15–25 minutes for a ten-room plan), then make each photograph lock onto it (about three minutes a photo). - Printable project sheets (A4 and US Letter, one page each, with a QR code back to the project).
- "Plain sheets": the whole site as still sheets — the fast, accessible view, and what reduced-motion visitors get.
- A title-block contact form (posts to Formspree / Basin / your endpoint, or opens the visitor's email app).
- Quiet sound made in the browser (room tone, footsteps on the floor finish, a soft knock at the lock) — off with one tap.
Start here: getting-started.md · the data file · the pin tool · print and plain sheets · static HTML · legal notes · accessibility · FAQ
Getting started
You need Node.js 20.9 or newer (22 or 24 LTS recommended).
npm ci # installs the exact versions in package-lock.json
npm run dev # http://localhost:3000 (the pin tool is at /pin while dev runs)- Open
src/data/studio.ts. Change the studio block: name, city, the value line, email, phone, address, people, phases. Setwording: "architects"andregisteredArchitect: trueonly if you are on your country's register (see legal.md). - Put each project's photographs in
public/work/<project-slug>/as.webp(about 2300 px wide) plus a 1200 px copy named<name>-1200.webpfor phones.npx sharp-clior Photoshop's "Export as" both work. - Replace a demo project with yours: its facts, its plan and one
stationper photograph. Trace the plan's walls in the pin tool's Walls mode (about 15–25 minutes for a ten-room plan — or start with no walls, see below), then pin each photo so it locks (about three minutes a photo) and runnpm run check:photosto see every photo's fit at once. A typical three-photo project: about 30–40 minutes. - Publish:
npm run build && npm starton any Node host (Vercel, Netlify, Render), ornpm run build:htmlfor a folder of plain files any static host serves (GitHub Pages, S3, cPanel).
Three levels — use whatever you have
| You give | You get |
|---|---|
| A plan and photos, no points | Plan and numbered photos on a printable sheet (level 0) |
| + 4 floor points per photo | The plan lands on the photo's floor, labels pinned, cones on the key plan (level 1) |
| + 2 height points and walls | The white model rises and locks onto the photo (level 2) |
A station that doesn't fit well is shown at level 1 by itself: the walls sink back into the plan at that view, so nothing ever shows a wall that misses the photo.
FAQ
Do I need a 3D model of my building? No. The white model is built from the walls in your plan (centre lines in metres). No walls? You still get the plan landing on each photo's floor.
My photos aren't perfectly straight. The pin tool tells you the fit. If only the floor fits, that view shows the plan on the floor and the walls sink away — it never shows a wall that misses.
Can I hide the budget question? Set budgetField: false.
Can I turn the sound off for good? sound: "none" removes the button; "off" starts muted.
How do I add a fifth project? Copy a project block, change the slug, the facts, the plan and the stations, and add it to the projects list at the bottom of the file. The work index draws every plan at the same scale automatically.
Where do I host it? Any Node host for the Next.js edition, or any static host for html/. No database, no login.
Accessibility
- Every photograph has written alt text; every plan is described in words (
drawing.alt). - All words are dark ink on light paper (no grey text). Keyboard: every control is reachable; the select menus work with arrows, Home/End, Enter and type-ahead; M turns sound on and off.
- Reduced motion → plain sheets (no pinning, no camera moves, no 3D). Sound never plays before a tap or key press and is silent for screen-recording and testing browsers.
- The loader shows real progress, is announced as a progress bar, and never blocks for more than 12 seconds.
The data file — src/data/studio.ts
Everything on the page, the printed sheets and the static-HTML copy comes from this one file.
studio
name, city, url (where the site will live — the printed sheets carry a QR code to it), line (one sentence for search results), valueLine (the italic line in the hero), proof (one award or press line), availability, email, phone, address (lines), people (name, role, note), phases (name, months like "3–4", what happens), takesOn, doesNotTake, units ("m2" or "sqft" — visitors can switch), sound ("on", "off" = off until a visitor turns it on, "none" = no sound button at all), budgetField (show the optional budget band in the form), formAction (a form endpoint; empty opens the visitor's email app with the brief written out), legal (privacyUrl — "#privacy" for the built-in footer notice or your own page; privacy — your own words for that notice; licenceNo; impressum), social, credit (true shows "Made with Station Point" in the footer — off by default; the free edition always shows it).
a project
slug, no, name, brief, place {city, country}, privateClient (true shows the city only and "Private client"), year, status ("Built" · "On site" · "In design" · "Concept"), typology, size (m², the page converts to sq ft), site, client, scope, constraints (the problems you solved — clients read these), duration {design, permit, build in months, or a note}, budgetBand ("off", "On request" or a range), team, collaborators {role, name}, photographer, awards, press, materials {what, maker}, story (60–90 words), drawing, stations, plates.
A project with no stations is shown as "in design": its plan rises into the white model and stays white.
drawing (the plan)
extent [x0, y0, x1, y1] — the sheet in metres. wallHeight. walls — each wall is a centre line a → b with a thickness t (and h when it differs); open lists its windows, doors and openings by distance from a (at, w, sill, head; doors: hinge, swing, closed: true when the photo shows it shut). blocks (furniture outlines), trees, areas (garden / paving / water), rooms {name, at, size} — the names that lie on the floor in the photos, alt — the plan described in words for screen readers and print.
No walls yet? Leave walls: [] and give src: an image of your plan. You get levels 0 and 1.
station (one per photograph)
id, room (matches a room name in the drawing), size ("5.0 × 6.8 m, 3.4 m high"), caption, light, photo {src, w, h, alt}, floor (4 points: plan metres ↔ photo pixels), heights (2 points at a known height), focus (the phone crop centre, 0–1), finish (the floor you hear: timber, stone, concrete, tile, carpet), tone (room, street, water, garden). The pin tool writes floor and heights for you.
plates
Extra photographs with no station (an exterior, a detail): shown on the sheet only.
Legal notes (not legal advice — check your own country's rules)
- "Architect" is a protected title in many countries. In the UK only people on the ARB register may use it in business, including in a website's page title and description. The theme keeps the word out of every generated title and description unless you set
wording: "architects"andregisteredArchitect: true. Add your registration number inlegal.licenceNo. - Germany and Austria (Impressum): fill
legal.impressum(chamber and its address, your professional title, the state that granted it, a link to the professional rules). It appears in the footer only when filled. - Privacy: the site sets no cookies and does no tracking; the contact form asks for one consent and only sends what the visitor typed.
legal.privacyUrl: "#privacy"shows a short notice in the footer that says exactly that (write your own words inlegal.privacy), or pointprivacyUrlat a page of your own. Fonts are served from your own site (no request to Google). - Photographs: credit the photographer on every project (
photographer); make sure you are licensed to use each photo on the web. Private clients: give the city only, never a street address (privateClient: true). - Demo photographs in this theme are made with Adobe Firefly and may stay in your copy; replace them with your own work.
The pin tool — make a photograph lock onto your plan
npm run dev, then open http://localhost:3000/pin. (It only exists while dev runs; it is never published.)- Pick the project and the photograph.
- Drag F1–F4 onto four points of the floor that you can also find on your plan: room corners where a wall meets the floor, the foot of a door frame, a tile or board line. Spread them out — two far, two near.
- Pick each point in the list and click where it is on the plan (the plan on the right is drawn from your data).
- For the full lock, tick use H1–H2 and drag them to two points at a height you know — usually the two top corners of the far wall — and type that height.
- Red lines show your white model seen from the solved camera. When they sit on the photo's edges, press Copy and paste the block into that station in
studio.ts.
Check every photo at once: npm run check:photos prints each photo's level and error (the same solver the site uses). A photo that isn't solved still shows on its project sheet; the walk-through simply skips it until it is.
What the verdict means: level 2 = the model locks; level 1 = only the floor fits (the walls will sink back into the plan at this view — still beautiful); not solved = move the points. The error is the worst miss in pixels.
Tips: don't put three floor points on one line (all along one wall foot) — the tool warns you; take one across the room. Shoot or choose photos with the camera level (vertical lines straight). Wide lenses are fine. If a room has furniture against every wall, use the edges of a rug or a floor pattern as floor points.
Walls — trace your plan for the white model
The white model is built from your plan's walls (centre lines in metres, with their doors and windows). Trace them in the same tool: open /pin, switch to Walls — trace your plan.
- Choose your plan image (PNG or JPG; export it from your drawing program at about 30–60 px per metre). Or press Practise on this project's plan to try it on a demo project first.
- Scale (K): click both ends of a length you know — a long wall or a dimension line — type it in metres and press Set the scale. The image's top-left corner is plan point 0, 0 unless you change it.
- Wall (W): set the thickness, then click a wall's two ends along its centre line. The next wall starts where the last one ended; click the same point twice (or press Esc) to stop. Walls snap square (hold Alt for any angle) and to the ends of other walls. A selected wall's ends can also be typed exactly.
- Opening (O): pick door, window or opening, then click its two sides on the wall. In the panel set the window sill and head heights, the door's hinge end and swing, and tick shut in the photos for a door that is closed in your photographs (the model then builds it shut).
- Select (V): click a wall or an opening to change it; Delete removes it; ⌘Z / Ctrl+Z undoes.
- Copy the walls and paste them over
extent,wallHeightandwallsin the project'sdrawinginsrc/data/studio.ts. Addrooms(name, centre point, size) by hand — they are the labels that lie on the floor.
How long it takes: about 15–25 minutes for a ten-room plan (our test rebuilt the demo flat — 10 walls, 13 doors and windows — in 81 clicks and entries; the model it built locks onto the three photographs as well as the original). Then pin each photograph (about three minutes a photo).
Print and plain sheets
Print this sheet (under each project's title) prints that one project on one page — A4 or US Letter, whatever the printer is set to; choose "Save as PDF" for a file. The sheet carries the title block, the plan with numbered view cones, the numbered photographs with credits, the facts table, the story and a QR code back to the project. Printing the page any other way (⌘P / Ctrl+P) gives every project's sheet, one per page — a ready portfolio PDF.
Plain sheets (header button) shows the whole site as still sheets: no pinning, no 3D, every word and photo in the page. It is remembered on the visitor's device. Visitors who ask their system for reduced motion get it automatically, and so does any browser without WebGL.
The static-HTML copy
npm run build:html writes html/: index.html, assets/ (one stylesheet, the fonts, one script) and work/ (your photographs). Upload the folder to any static host. It needs http(s):// — browsers block WebGL textures from pages opened straight from disk. To try it locally: npx serve html.
Change words, projects or photos in src/data/studio.ts and run the command again (about a minute). Small text edits can also be made directly in html/index.html; the plans and stations live in the JSON at the end of that file.