matthewgvc.github.io

GVC Workspace — the GVC Team's (Douglas Elliman) production workspace: every listing and new development with its facts, milestones and pieces, and the tools that make those pieces.

Static site, no build step. GSAP via CDN on the tool pages that animate.

Local preview

python -m http.server 8080
# open http://localhost:8080 (it opens the workspace)

Workspace

/ forwards to workspace/. Its menu: Overview (every job's stage and milestones), Resell (listings, rentals and pitches), New Dev (developments), Errors (where Drive, Asana and DE disagree, workspace/match/) and Tools (workspace/tools/, the list of the tools below, all but Map Studio, which opens from a job). A job's own page is workspace/job/?listing= / ?pitch= / ?dev=. Sign-in is per person (Supabase); the desktop helper in helper/ (see its README) syncs DE and Asana and writes PDFs into the job's Drive folder.

Pieces made from a job (Showsheet, Brochure, Postcards, Seller Package, Signage): the helper makes them. Make / Rebuild on a job page (any device, owner, admin, marketing or the team account), Rebuild n stale, or Make PDF on the piece's own page add a row to piece_requests (migration 0017); the helper reads the job folder itself, lays the piece out with the piece's own page (assets/js/piece-mode.js plus each tool's job-mode.js adapter) and saves it into the folder. Requests wait while the helper is off. Tests: scripts/test-piece-build.js, test-piece-page.js, test-sheet-page.js, test-job-page.js.

Archiving a job: a listing's or development's page has Archive / Restore in its header (owner only; the first click asks "Confirm archive?"). A listing archives by its stage; a development by dev_projects.archived_at (migration 0018). Archived jobs leave the overview, the lists and the error count until "Show archived" is ticked.

Development addresses: assets/js/dev-addresses.js lists the street each development's units are listed at on DE, so the Errors page treats those DE listings as the development's units (add a development there when its units go on DE).

The team roster: Asana's 👋 People project is the master. assets/js/roster.js and assets/js/bios.js follow it (the helper's asana-sync.js --people copies it into asana_people).

Deploy

Push to main. GitHub Pages serves the repo root.

Scripts

Python: pip install -r scripts/requirements.txt (the floorplan scripts, film grain, phone mockup). Node: plain node, except the scripts that open pages, which need Playwright (cd scripts && npm install once) and the site served on :8080. Every check exits non-zero on a failure.

• scripts/test-*.js — one test per shared module or page (test-job-facts.js, test-match-check.js, test-piece-build.js, test-listing.js…); run the ones for what you changed
• check-tools.js — every tool against the house conventions (head, fonts, SRI, panel, labels, listed on the Tools page, test lists); node scripts/check-tools.js <slug> for one
• verify-local.js — load every page on localhost:8080 and fail on console errors, uncaught errors, SRI blocks, missing files, missing chrome or sideways scroll; worth running before a publish
• interact-local.js — click through every editor control on every tool (sections, buttons, dropdowns, checkboxes, sliders, awkward text), print each to PDF, and fail on any error. node scripts/interact-local.js brochure runs one tool. A tool's own "text runs past the page" warning is listed, not failed
• dnd-local.js — drag photos around the brochure, Seller Package, buyer package and showsheet with real mouse events, and fail if a photo ever shows in two places
• baseline.js — print every tool's reference pages to exports/baseline/<date>/; node scripts/baseline.js --compare <date> fails if any printed page moved
• make-floorplan.js — draw a job's floorplan from its Floorplan\Design\plan.json (the making-gvc-floorplans skill)
• job-folders.js — check or build a job's Drive folder against the standard in assets/js/drive-rules.js
• make-png.js / check-svgs.js — regenerate and render-check the monogram favicons and lockup SVGs
• sync_todo.py — the SQL that mirrors docs/todo.md onto the live To-do page

Showsheet tool

tools/showsheet/ is a listing-showsheet generator (drop a .docx, photo, and floorplan → print-ready A5 or US Letter). The page is index.html; what it reads out of a listing — the Word document and the money fields — is listing.js, kept apart so scripts/test-listing.js can run it without a browser. Its editor panel uses the builders' shared assets/css/builder.css; photo and floorplan handling is assets/js/images.js, shared with the Brochure; its logos are files in assets/logos/sheet/, read once at startup and placed inline. Opened from a job (?listing=<slug>) it runs on the shared piece mode; job-mode.js is only the sheet's adapter.

A sample listing lives in tools/showsheet/sample/ (555 W59th PHC — listing.docx, hero.jpg, floorplan.jpg); open "Listing files" and drop those three onto the tool to see a fully populated sheet. There is no button that loads them for you (an older one was retired). Needs the site served over http (fetch can't read file:// siblings).

Destination Guide tool

tools/destination-guide/ builds a sourced, print-ready US Letter regional guide. Its first complete dataset is Monmouth County. Guide facts, POIs, map coordinates, team picks, and source URLs live in guide-data.js; the page renderer and editor are separate so research can be corrected without touching the layouts. The preview supports live cover/welcome edits, session-only image replacement, an optional Team Favorites page, JSON handoff, and Print / Save PDF.

NJ Footprint tool

tools/nj-footprint/ is a two-page, print-ready US Letter sheet — where the team sells in New Jersey, with counts and dollar volume. It has no editor panel: the sheet draws itself from transactions.js (one row per sale), and footprint.js does the arithmetic. The rows are the team's 106 closed NJ sales from the MLS (TJ, James and Marli). The front page is NJ by county and the back is a Monmouth + Ocean town-by-town map; ?view=towns gives a no-figures version. After replacing rows, run node scripts/test-nj-footprint.js.

Signage tool

tools/signage/ makes the team's For Sale sign (24 x 30 in: up to two agents and a QR, as the sign files in GVC - Marketing > GVC - For Sale Sign) and the Open House arrow sign (24.4 x 18.4 in, left or right). Standalone the choices are kept in localStorage; opened from a job it makes the For Sale sign with the job's agents and listing QR and saves through the helper (Slice 6). Tests: scripts/test-pdf-render.js.

Postcards tool

tools/postcard/ makes a two-sided 6 x 9 in Just Sold or For Sale postcard, at Vistaprint's 9.21 x 6.21 in bleed size or at trim size. Everything is typed or dropped in (photos are not saved; the words are, in localStorage); agents come from the roster. The back keeps its lower right clear for the mail house. Tested by node scripts/interact-local.js postcard.

Brochure tool

tools/brochure/ builds a property brochure, printed at 8.5 x 11 or 5.5 x 8.5 in (toggle under the preview). Photos are dragged onto the pages; the panel has the gallery layout and crops, the property facts, floor plans (two per page) and up to two agents. The property bar at the top of the panel saves the facts and the brochure, photos included, to the shared property library (signed in) and loads them back. Opened from a job (?listing=<slug>), job-mode.js fills it from the job instead. Print / Save PDF prints it.

Seller Package tool

tools/seller-package/ builds an 8.5 x 11 listing presentation and CMA: a classic or guide page design, a per-agent version, the property, the client and cover, comparable sales, the listing strategy, professional videos, client testimonials and up to two agents. It saves and loads through the same property bar as the Brochure. Opened from a job (?listing=<slug> or ?pitch=<slug>), job-mode.js takes the subject, comps, agents and photos from the job. The Market panel's New Jersey / New York switch follows the property's State field and sets the market-specific Marketing Plan rows and the Videos page prose; it is usually right untouched. Print / Save PDF prints it.

Buyer Package tool

tools/buyer-package/ builds the 8.5 x 11 buyer packet: the process, the costs and the questions to ask, for New Jersey, New York City or Florida. The panel picks a per-agent version, the page design, the cover market and title, photos, which pages show, the New Jersey offer and negotiation text and up to two agents. Nothing is saved: the page asks before you leave with changes, and Print / Save PDF is the output. The copy lives in guide-data.js.

Agent Crib Sheets tool

tools/agent-info/ prints the agent's own crib sheets: "Don't Forget to Ask", "FAQ's" and a draft Buyer Cheat Sheet (marked Check, not for use until reviewed). Pick the market (NJ, NYC, FL) and the pages; there is nothing to type and nothing is saved, but the page asks before you leave once a choice has changed. The copy comes from tools/buyer-package/guide-data.js through assets/js/agent-pages.js.

Retired pages

tools/properties/ and tools/cma/ are redirects only: Properties to the workspace's Resell list (every listing is a job now), the CMA to the Seller Package. tools/new-development/ is archived: kept in the repo, off the Tools page and the checks (only baseline.js still prints it); developments live on the workspace's New Dev page.

Floorplan Converter tool

tools/floorplan/ turns a CubiCasa floorplan SVG into a GVC-branded SVG: navy palette, Nunito Sans labels, CubiCasa footers and dimension arrows removed, named layers, ready for Illustrator. Drop the SVG, compare Converted and Original, then download <name>_gvc.svg. It runs in the browser (floorplan.js); nothing is uploaded or saved.

Watermark tool

tools/watermark/ (also linked from a job's Photos card) adds a Virtually Staged or Virtually Renovated label to listing photos. Drop photos or a folder, pick the label, the corner and the size (50 to 200%), then Download saves each photo as <name>-virtually-staged (or -virtually-renovated), as JPG or PNG to match. It runs in the browser; nothing is uploaded or saved, and the page asks before you leave with photos loaded.

Map Studio tool

tools/map-studio/ (opened from a job's Seller Package row; it has no place on the Tools page) places numbered pins for a list of addresses on a 3D Mapbox map, with a legend, and exports a PNG (gvc-3d-property-map.png) at a chosen shape. It needs a Mapbox access token, typed into the page. Opened from a job (?pitch=<slug> or ?listing=<slug>), job-mode.js maps the job and its comps, remembers the token on that computer, and the owner can save the map to the job through the helper. The page asks before you leave with unexported changes.

Feet & Inches Calculator tool

tools/calculator/ adds or subtracts measurements in feet and inches and shows the total as feet and inches, total inches and decimal feet. Nothing is saved.

Office Screens tool

tools/office-screens/ previews the looping motion pieces for the office TVs, each in landscape and portrait, drawn live by screens.js. There is a Pause / Play button. The finished 4K videos are not on the site.

Docs

• Working docs (status, to-do, decisions, facts, folder standard) live in docs/, local only: docs/ is gitignored, so they do not ship with a clone. The one exception is docs/piece-helper-design.md, which the code cites.

To-do tool

tools/todo/ is Matt's to-do list (only Matt's sign-in reads or writes it, migration 0008; internal, not indexed). It mirrors docs/todo.md via python scripts/sync_todo.py (see the script). Rows live in the Supabase todos table (migration 0003_todos.sql). Tested by node scripts/interact-local.js todo.