Unlisted prototype: https://umn-vr.github.io/tour/makerspaces/
This repository owns a new FOSS Earth scene and its independent host page.
The existing /tour/ campus selector, campus pages, runtime and media are not
rebuilt or changed by this prototype's deployment. No navigation link is added
to the campus selector. Search engines receive noindex, nofollow, noarchive;
the URL is public to anyone who has it.
The starting 360° view is the existing Toaster Innovation Hub panorama from the Twin Cities tour. The Anderson Labs previews are ordinary photographs, clearly labeled separately from the panorama. Other spaces have verified directory entries and official links, with further photography to collect. Imagery is a reference to the photographed space, not a current equipment or access guarantee. Check each space's official site before visiting.
Use the same side-by-side workspace as UMN-VR/tour:
UMN-VR/makerspaces, UMN-VR/twin-cities, the FOSS Earth repositories under
foss-earth/, and Felipegalind0/gamepad-tools. Install the FOSS Earth app's
dependencies first if needed. Then:
npm install
npm run devUse the address printed by Vite, with /tour/makerspaces/. Stop an existing
server before reusing its port. Open + → Makerspaces for the directory and
tour controls, which live in the app's native tab interface. There is no separate
top bar. ?embed=1 uses the same tabbed interface in an iframe;
embed-preview.html demonstrates that view.
content/spaces.json: campus, room, short description, official source and photograph metadata for every directory entry.content/tour.json: the source scene and selected genuine panoramas.scripts/build-scene.mjs: generatesscene.json, retaining image revisions, attribution and placement provenance while resolving media to existing URLs.public/media/: Anderson Labs reference photographs; sources and rights are documented in research.
After selecting or changing a panorama, run npm run build:scene. The source
defaults to the sibling Twin Cities scene. The generated scene contains no
fabricated capture points and no links to absent panoramas. Its Toaster image
URLs continue using /tour/twin-cities/media/; no parent media are replaced.
The shared app includes + → Add image: view a Google panorama with Google's viewer, or add a prepared original to a validated scene draft and download it. The nearby Google orb discovery layer is a proposed follow-up, not implemented.
Your Anderson Labs Google Maps photographs have not yet been identified. Record exact share links and confirm their uploader before importing originals; do not infer ownership from the place listing. See research for the research inventory and next capture work.
The reusable tools live in @foss-earth/sphere-image and @foss-earth/scenes;
this repository exposes them without copying their implementation:
npm run download:panorama -- --help
npm run download:panorama -- --list
npm run download:panorama -- --photo-id YOUR_OWN_PHOTO_ID \
--out build/anderson-original --prepare-out public/media/anderson-design-360 \
--attribution "Photo by the photographer" \
-- --asset-id anderson-design-360 --url-prefix media/anderson-design-360/Google owner downloads need STREETVIEW_PUBLISH_ACCESS_TOKEN in the local
environment, with the streetviewpublish OAuth scope. It is never saved in the
repository. The existing Maps key is for viewing, not owner-download authority.
Use a local original or an explicitly permitted original URL when appropriate.
The output is equi-angular cube tiles (EAC), with preview cubes and a whole
equirectangular fallback. Additional preparation arguments follow --.
To retain a prepared photo in this generated tour, copy its
asset.fragment.json into content/imports/ and append this input to the
imports array in content/tour.json (use the actual capture coordinates):
{
"fragment": "content/imports/anderson-design-360.json",
"id": "anderson-design-360",
"title": "Anderson Design Lab",
"latitudeDeg": 44.9755,
"longitudeDeg": -93.233224,
"mediaBaseUrl": "https://umn-vr.github.io/tour/makerspaces/",
"groupId": "east-bank"
}Those example coordinates are the building marker, not a verified capture
position. Replace them before importing. Then run npm run build:scene and
add the panoramaId to the corresponding entry in content/spaces.json.
The generated scene preserves attribution/orientation and leaves unmeasured
capture height null. The image files must be published with the prototype.
npm run add:image -- --help also builds standalone scene drafts from fragments;
use authoring inputs above for this generated tour. See the shared
download/import guide at foss-earth/sphere-image/docs/download-and-import.md
for source, authorization and preparation details. The shared Add image,
authoring and download APIs are under development in the adjacent FOSS Earth
checkouts; this prototype is built against those local sources.
Keep changes local for the user's own testing. Push source or run a deployment only when the user explicitly requests that specific action; these commands are documentation, not authorization. Agent browser tests do not replace user testing.
npm test
npm run build
npm run deploy -- --dry-run
npm run deployPublishing uses an alternate Git index in the sibling tour checkout and
overlays only makerspaces/ in its current remote gh-pages tree. It checks
every changed path before a normal fast-forward push. Existing pages, shared
assets and media remain byte-for-byte unchanged; old makerspaces assets stay
available for open tabs. No whole-tour build, service-worker update or homepage
deploy is performed. Push access to UMN-VR/tour is required. Source is pushed
separately to UMN-VR/makerspaces.
See embedding for the proposed makers.umn.edu iframe and the later step of adding a tour-selector link. Neither integration is enabled by this prototype.
Code is AGPL-3.0-only. University photographs retain their original
copyright, © Regents of the University of Minnesota, and are not relicensed
by the code license. No University endorsement is implied. Building placement
provenance and source credits are retained in scene.json. Review image reuse
and branding with UMN before institutional launch.