Locus

Intermediate · 15 minutes

Publish your own skybox shelf.

GitHub Pages can turn a repository into a simple public website at github.io. Put compatible panoramas there, link to each full image, then open the site in Locus Browser whenever you want to preview or save one.

Your site and images will be public. Do not upload private room photos, personal information, location details, or an image you do not have permission to publish.

Before you begin

GitHub's web uploader accepts files up to 25 MiB. Larger files can be added with GitHub Desktop or Git, but regular GitHub repositories block files above 100 MiB, and Git LFS does not work with GitHub Pages. See GitHub's current file limits.

1 · Create

Make the repository

  1. Create a new repository on GitHub. A name such as my-locus-skies is easy to recognize.
  2. Choose Public if you use GitHub Free, then add a README.
  3. Upload your panorama files. Use Add file → Upload files. Commit the upload to the main branch.

A project site will use an address like https://YOUR-NAME.github.io/my-locus-skies/. If you instead name the repository YOUR-NAME.github.io, it becomes your one account-level site at https://YOUR-NAME.github.io/. GitHub explains both choices in What is GitHub Pages?

2 · Add a page

Link to the full images

Choose Add file → Create new file, name it index.html, and paste this starter. Replace the filenames and titles with your own, then commit the file.

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>My Locus Skies</title>
<style>
  body { max-width: 44rem; margin: 4rem auto; padding: 0 1rem;
         font: 18px/1.6 system-ui; color: #eef6f8; background: #0d141a; }
  a { display: block; margin: 1rem 0; padding: 1rem;
      color: #b8dcea; border: 1px solid #33434c; border-radius: 12px; }
</style>
<h1>My Locus Skies</h1>
<p>Open a full image in Locus Browser to preview or save it as a View.</p>
<a href="aurora-lake.jpg">Open Aurora Lake</a>
<a href="desert-sunrise.jpg">Open Desert Sunrise</a>
</html>
The link must open the image itself. Locus offers View actions only when the complete panorama fills its own Browser tab. An image embedded inside the webpage is not enough.

3 · Publish

Turn on GitHub Pages

  1. Open the repository's Settings.
  2. Choose Pages.
  3. Under Build and deployment, publish from a branch. Choose main and the repository root, then save.
  4. Wait for GitHub to show the site address. Open it and test every panorama link.

GitHub Pages sites are public on the internet. GitHub's site creation guide and publishing-source guide show the current controls.

4 · Use in Locus

Preview or save any compatible sky

  1. Open your github.io site in Locus Browser.
  2. Choose one of your Open links. The full panorama should fill the tab.
  3. Choose Apply Preview to try it in the current Place for this app session without using an import.
  4. Choose Save as View… to add it permanently to Places and apply it immediately.

If the prompt does not appear, confirm that the page shows only the image, the file is JPEG, PNG, or HEIC, and its displayed dimensions are at least 4,096 × 2,048 with an exact 2:1 ratio. The online View guide has the complete checklist.

Advanced

Keep the shelf useful