Skip to content

feat: redesign homepage around the North Star - #14

Merged
jBernavaPrah merged 4 commits into
mainfrom
codex/north-star-manifesto
Sep 1, 2026
Merged

feat: redesign homepage around the North Star#14
jBernavaPrah merged 4 commits into
mainfrom
codex/north-star-manifesto

Conversation

@jBernavaPrah

@jBernavaPrah jBernavaPrah commented Sep 1, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Reframe phoxal.com as a focused, North Star-led project manifesto.
  • Present one true eight-stage loop from Author through Promote, attach the promotion gate to the Evaluate-to-Promote transition, and show the return to Execute.
  • Tighten the hero so the project status, headline, product definition, and primary actions establish the complete promise in the first viewport.
  • Center the product definition through mobile layouts and set the final invitation as three deliberate lines.
  • Use one canonical product definition and the exact phrase giving up control throughout visible copy, metadata, and the social card.
  • Self-host Inter Variable with its OFL license, improve muted-text contrast, normalize type weights, and preserve the restrained Phoxal palette.
  • Add a 180 by 180 Apple touch icon, robots.txt, sitemap.xml, corrected Open Graph metadata, and a true 1200 by 630 PNG social card.
  • Keep the page static, dependency-free at runtime, and JavaScript-free.

Design and scope

The page leads with the enduring project promise rather than current implementation details.
It tells one continuous story through the problem, North Star, governing principles, development posture, and invitation to participate.
The visual system is intentionally typographic and technical without using dashboard cards, decorative grids, gradients, robot art, or remote fonts.

The website is the public project vision and introduction.
Repository-specific APIs, commands, implementation details, and examples remain with the repositories that own them.

Deliberate decisions

The issue's suggested headline punctuation conflicts with the organization-wide rule against em dashes.
The rendered H1 is Build robots that improve without giving up control.
This preserves the locked meaning while complying with the governing writing rule.

assets/phoxal-logo-vertical-transparent.png remains temporarily even though the homepage no longer loads it.
The current organization profile still consumes its stable public URL.
phoxal/.github#46 removes that consumer, after which the compatibility asset can be deleted in a focused follow-up.

Review performed for this change

  • html-validate@11.11.0 --max-warnings 0 index.html
  • bash -n install.sh
  • shellcheck install.sh
  • git diff --check
  • Manual semantic audit for one H1, unique IDs, valid fragments, eight ordered lifecycle stages, exact canonical copy, complete metadata, local asset existence, valid image dimensions, robots.txt, sitemap.xml, and zero scripts
  • Unused CSS class audit with no unused selectors
  • Chrome review at 320, 390, 768, 1024, 1366, and 1440 CSS pixels with zero horizontal overflow
  • Equivalent 200 percent reflow review at a 683 CSS pixel viewport
  • Keyboard skip-link review, including retained focus on the main content target
  • Mobile primary actions verified at 52 pixels high and mobile navigation targets at 44 pixels high
  • JavaScript-disabled, reduced-motion, and remote-font-free review
  • Social card verified as a true 1200 by 630 PNG, Apple touch icon at 180 by 180, and favicon at 64 by 64
  • Independent visual and code review completed with no remaining objective findings

These were one-time review checks for this change.
The repository remains a plain GitHub Pages site with no validation script or CI workflow.

Visual review

Desktop

Hero at 1366 by 768:

Phoxal refined desktop hero

Eight-stage North Star loop and promotion return:

Phoxal eight-stage North Star loop on desktop

Governing principles:

Phoxal governing principles on desktop

Development statement:

Phoxal development statement on desktop

Final invitation and footer:

Phoxal three-line invitation and footer on desktop

Mobile

Hero at 390 by 844:

Phoxal mobile hero with centered product definition

Three-line invitation:

Phoxal three-line invitation on mobile

Vertical lifecycle stages:

Phoxal vertical lifecycle stages on mobile

Promotion gate and return to the next release:

Phoxal promotion gate and return path on mobile

Closes #13

Signed-off-by: jbernavaprah <webjure@gmail.com>
Signed-off-by: jbernavaprah <webjure@gmail.com>
Signed-off-by: jbernavaprah <webjure@gmail.com>
Signed-off-by: jbernavaprah <webjure@gmail.com>
@jBernavaPrah
jBernavaPrah merged commit e821420 into main Sep 1, 2026
@jBernavaPrah
jBernavaPrah deleted the codex/north-star-manifesto branch September 1, 2026 19:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Redesign phoxal.com as a North Star-led one-page project manifesto

1 participant