Skip to content

GitHub Pages project-site subpath will break internal links/assets #2

Description

@michielbdejong

Problem

Every internal link and asset reference the app renders is a root-absolute path, e.g. (from the crawled /write page):

<link rel="canonical" href="/write" />
<script src="/open-write/__compiled/ui-behaviour.js"></script>
<link ... href="/_shared/__external/normalize.css/normalize.css">

These assume the site is served from the domain root. A GitHub Pages project site (this repo is hyperdraft, not the special pondersource.github.io repo) is served from https://pondersource.github.io/hyperdraft/ by default — a subpath — unless a custom domain (CNAME) is configured. There's no CNAME file in the repo and no base-path handling in os-app (checked via grep for OLSKRoutingBase/basePath/<base — nothing found).

Impact

Once static.yml successfully deploys (see the separate Pages-environment-config issue), the live URL will very likely 404 on nearly every asset, script, and internal link, unless a custom domain resolving to the repo root is set up.

Suggested next steps

  • Decide: custom domain (add CNAME, keep root-absolute paths as-is), or
  • Configure the app/build to prefix all asset and route URLs with a base path (e.g. /hyperdraft) when building for the project-site URL.

https://claude.ai/code/session_01AcjKc8vk2fb84yYZsE8k5d

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions