UI/UX first: visual README, GitHub Pages portal, fix all dead nav links by Copilot · Pull Request #44 · BlackRoad-OS/.github

Copilot · 2026-03-10T09:24:58Z

The repo had a placeholder README ("Enter file contents here"), six non-functional href="#" nav links in the pixel portal, and no hosted URL — making the entire UI inaccessible without cloning and running locally.

Changes

`README.md` — full rewrite

Replaced placeholder with a visual landing page: branded badges, three CTA buttons (Launch Portal / Play Games / Website), a "just click it" link table for all portals and games, plain-English description of BlackRoad, org tier directory, and repo explorer

`.github/workflows/pages.yml` — new GitHub Pages deployment

Deploys blackroad-pixel/ to GitHub Pages on push to main
Portal live at https://blackroad-os.github.io/.github/; games at .../games/

`blackroad-pixel/index.html` — nav links

All six nav items were href="#"; replaced with real destinations:

- <a href="#" class="nav-item">Repositories</a>
- <a href="#" class="nav-item">Files</a>
- <a href="#" class="nav-item">Terminal</a>
+ <a href="https://github.com/BlackRoad-OS" class="nav-item" target="_blank" rel="noopener">Repositories</a>
+ <a href="https://github.com/BlackRoad-OS/.github" class="nav-item" target="_blank" rel="noopener">Files</a>
+ <a href="https://github.com/BlackRoad-OS/.github/blob/main/README.md" class="nav-item" target="_blank" rel="noopener">Docs</a>

`blackroad-pixel/app.js` — nav click handler

Handler was calling e.preventDefault() unconditionally, silently swallowing all nav clicks; now only prevents default on # anchors

`profile/README.md` — org profile hero

Replaced plain-text header with branded badge, three launch buttons, and a portal quick-link table — first thing visitors to the org now see is a working "Launch Portal" button

Original prompt

If it doesn't build here it should be buildable via one of our million websites or devices. No one wants to get hacked in their terminal. No one likes to debug. So bring it UI UX first. Assume no one will use this unless it is spoon fed to them. Click this link see it work. That's it. Don't assume all this weird jargon and stuff with ai for the average person. We want people to dream. And right now these repos dont read like easy to use. It sounds like nightmares to start, annoyances for broken links, code files. Just embed the dang portals dude and get the links working. If the code isn't visual, our number 1 priority is to make it.

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

…nav links - Replace placeholder README.md with visual landing page (clickable badges, portal links, org directory, plain-language copy) - Add .github/workflows/pages.yml to deploy blackroad-pixel/ to GitHub Pages - Fix all 6 dead href='#' nav links in blackroad-pixel/index.html (Dashboard, Repositories, Files, Docs, Tools, Agents) - Fix app.js nav handler that blocked real link navigation via e.preventDefault() - Add visual hero section to profile/README.md with launch buttons and portal quick-links Co-authored-by: blackboxprogramming <118287761+blackboxprogramming@users.noreply.github.com>

github-actions · 2026-03-10T09:39:00Z

Workflow Changes Detected

This PR modifies GitHub Actions workflows. Please ensure:

Workflow names are descriptive
Secrets are properly referenced
Triggers are appropriate
Jobs have appropriate permissions

Automated workflow review

Copilot

Pull request overview

This PR improves first-run UI/UX by turning the repo into a “click-to-use” entrypoint: a visual README/org profile, a GitHub Pages deployment for the pixel portal, and functional navigation links inside the portal.

Changes:

Rewrote README.md into a visual landing page with CTAs and a quick-link table to the portal and games.
Added a GitHub Actions workflow to deploy blackroad-pixel/ to GitHub Pages on pushes to main.
Replaced dead href="#" top-nav links in the pixel portal and adjusted the JS click handler to only prevent default on # links.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
`README.md`	New visual landing page + direct links to portal/games and repo map.
`.github/workflows/pages.yml`	Adds Pages deployment pipeline for `blackroad-pixel/`.
`blackroad-pixel/index.html`	Replaces placeholder nav links with real destinations.
`blackroad-pixel/app.js`	Allows real links to navigate by not always calling `preventDefault()`.
`profile/README.md`	Updates org profile README with branded hero + launch buttons.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

You can also share your feedback on Copilot code review. Take the survey.

Copilot · 2026-03-10T09:49:51Z

README.md

+[![🚀 Launch the Portal](https://img.shields.io/badge/%F0%9F%9A%80_Launch_the_Portal-0d0d1a?style=for-the-badge&color=ff6b9d)](https://blackroad-os.github.io/.github/)
+&nbsp;
+[![🎮 Play Games](https://img.shields.io/badge/%F0%9F%8E%AE_Play_Games-0d0d1a?style=for-the-badge&color=c44dff)](https://blackroad-os.github.io/.github/games/)
+&nbsp;
+[![🌐 Website](https://img.shields.io/badge/%F0%9F%8C%90_blackroad.io-0d0d1a?style=for-the-badge&color=00d4ff)](https://blackroad-os.github.io)


The “Website” CTA badge text says blackroad.io, but the link currently points to https://blackroad-os.github.io. This is misleading and inconsistent with other repo docs that treat https://blackroad.io as the canonical website; update the href to the intended domain, or change the badge label to match the GitHub Pages URL.

Copilot · 2026-03-10T09:49:51Z

blackroad-pixel/app.js

+      const href = item.getAttribute('href');
+      // Only prevent default for same-page anchors; let real links through
+      if (!href || href === '#') {
+        e.preventDefault();
+      }
      navItems.forEach(n => n.classList.remove('active'));
      item.classList.add('active');
    });


This click handler always toggles the .active class even when the user clicks an external link (e.g., Repositories/Docs) that opens in a new tab. This can leave the current page highlighting an item that didn’t actually navigate; consider only updating the active state for in-portal navigation (relative URLs / same-page anchors) and skipping it for http(s):// links.

Copilot · 2026-03-10T09:49:52Z

profile/README.md

+[![🚀 Launch Portal](https://img.shields.io/badge/%F0%9F%9A%80_Launch_the_Portal-ff6b9d?style=for-the-badge)](https://blackroad-os.github.io/.github/)
+&nbsp;
+[![🎮 Play Games](https://img.shields.io/badge/%F0%9F%8E%AE_Play_Games-c44dff?style=for-the-badge)](https://blackroad-os.github.io/.github/games/)
+&nbsp;
+[![🌐 Website](https://img.shields.io/badge/%F0%9F%8C%90_Website-00d4ff?style=for-the-badge)](https://blackroad-os.github.io)
+


The org profile “Website” button currently links to https://blackroad-os.github.io (GitHub Pages) rather than the main site used elsewhere (https://blackroad.io). If the intent is to send visitors to the primary website, update the href; otherwise rename the button to clarify it’s a GitHub Pages site.

Copilot

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

You can also share your feedback on Copilot code review. Take the survey.

Copilot · 2026-03-10T09:50:32Z

.github/workflows/pages.yml

+concurrency:
+  group: pages
+  cancel-in-progress: false


concurrency.cancel-in-progress is set to false, which can allow an older Pages deploy run to finish after a newer one and overwrite the site with stale content. Set cancel-in-progress: true (or use a commit-specific group) so the latest push reliably wins.

Copilot · 2026-03-10T09:50:32Z

blackroad-pixel/app.js

+      const href = item.getAttribute('href');
+      // Only prevent default for same-page anchors; let real links through
+      if (!href || href === '#') {
+        e.preventDefault();
+      }


The comment says "Only prevent default for same-page anchors", but the condition only matches '#' (placeholder) and will not cover real same-page anchors like #section. Either adjust the comment to reflect the actual intent (placeholder # links) or broaden the condition to handle all hash anchors if that’s what you want.

Initial plan

1667fac

Copilot AI assigned Copilot and blackboxprogramming Mar 10, 2026

Copilot started work on behalf of blackboxprogramming March 10, 2026 09:26 View session

Copilot AI changed the title ~~[WIP] Enhance UI/UX for better user accessibility~~ UI/UX first: visual README, GitHub Pages portal, fix all dead nav links Mar 10, 2026

Copilot finished work on behalf of blackboxprogramming March 10, 2026 09:39

blackboxprogramming marked this pull request as ready for review March 10, 2026 09:45

blackboxprogramming requested review from Copilot March 10, 2026 09:45

Copilot started reviewing on behalf of blackboxprogramming March 10, 2026 09:45 View session

Copilot AI reviewed Mar 10, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

UI/UX first: visual README, GitHub Pages portal, fix all dead nav links#44

UI/UX first: visual README, GitHub Pages portal, fix all dead nav links#44
Copilot wants to merge 2 commits intomainfrom
copilot/improve-ui-ux-for-users

Copilot AI commented Mar 10, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Mar 10, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Mar 10, 2026

Uh oh!

Copilot AI Mar 10, 2026

Uh oh!

Copilot AI Mar 10, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Mar 10, 2026

Uh oh!

Copilot AI Mar 10, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

Copilot AI commented Mar 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

README.md — full rewrite

.github/workflows/pages.yml — new GitHub Pages deployment

blackroad-pixel/index.html — nav links

blackroad-pixel/app.js — nav click handler

profile/README.md — org profile hero

Uh oh!

github-actions bot commented Mar 10, 2026

Workflow Changes Detected

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Mar 10, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 10, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 10, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Mar 10, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 10, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Copilot AI commented Mar 10, 2026 •

edited

Loading

`README.md` — full rewrite

`.github/workflows/pages.yml` — new GitHub Pages deployment

`blackroad-pixel/index.html` — nav links

`blackroad-pixel/app.js` — nav click handler

`profile/README.md` — org profile hero