Skip to content

Landing page: try every kind of learning from the hero - #248

Merged
ZeeshanAdilButt merged 8 commits into
mainfrom
feat/landing-try-it
Nov 18, 2026
Merged

ZeeshanAdilButt merged 8 commits into
mainfrom
feat/landing-try-it

Conversation

@ZeeshanAdilButt

@ZeeshanAdilButt ZeeshanAdilButt commented Nov 18, 2026 •

Copy link
Copy Markdown
Member

Makes the Edorax landing page something you can try, not only read about.

What changes

  • Hero: "The Student reader: easier to read, tidier header, works on phones #1 platform for" with the last words typed out, held and deleted (hands-on labs, interactive labs, learning, practice) with a blinking cursor. It pauses on hover, stops after two cycles, and screen readers get the whole sentence once.
  • Try-it panel (replaces the single hero question). One try per step, because visitors are short on time: a wrong answer shows the right one with the reason, and Next appears either way:
    1. The networking question from the old hero.
    2. Drag the four steps of loading a page into order (mouse, touch, or keyboard: Space to pick up, arrows to move).
    3. A quick Linux lab behind Launch lab: a practice terminal in the page (pwd, ls, cat welcome.txt, plus cd, mkdir, tab completion and history, plus a Run it for me button). It says clearly that the real shell labs run on a real machine in the desktop app, and links there.
    4. The real visual lab (hld-m4-three-tiers), opened full screen. Any finished run opens Next; a full pass counts as right. Both labs can be skipped.
    • Puzzles and voice tutors show as "soon" slots in the step list (try-it/steps.ts), ready for a component each.
  • New sections after the courses story: Hands-on labs (visual, guided, shell, copy from LAB_KINDS) and The desktop app (download link).
  • packages/learning-ui: HldBoard gets an optional onRunDone callback and is exported, so a page can open one lab full screen and hear the result. Nothing changes for existing callers.

Page speed

Only the first step ships with the page: about 3 to 4 KB gzipped more than today. The other steps load when a visitor reaches them (1.6 to 3 KB each). The visual lab board and its drawing library (about 75 KB gzipped) load only when someone presses Launch visual lab.

Checked

  • tsc --noEmit, eslint on the changed files and next build pass.
  • Local preview at phone width (375) and desktop width (1280): every step passes end to end, including a 4/4 pass on the real lab that unlocks the finish screen. A failed run shows "Best run so far: 1 of 4 checks". The keyboard path works for the question, the order step (Space and arrows), the terminal, and the lab launch. Focus moves to each new step and back to the launch button after Esc.
  • Reduced motion: no typing or cursor (whole words swap), step and Next button animations are off, and the terminal boot is instant.
  • The landing stays light only, as agreed, matching the approved design.

Not merged: waiting for a go-ahead.

HldBoard takes an optional onRunDone callback with the passed and total
checks of each finished run, and the package exports HldBoard so a page
can open one lab full screen. The landing page uses this to unlock its
next step when a visitor passes the lab.
A short run through every kind of learning: a course question, a drag to
order step, a quick Linux lab in a practice terminal behind Launch lab,
and the real visual lab opened full screen. Each step opens the next one
only on a right answer. Puzzles and voice tutors are listed as coming
soon slots in the step list.

Only the first step ships with the page. The other steps, the terminal
and the visual lab board load when a visitor reaches or launches them.
Order and visual steps work with a mouse, touch and the keyboard, focus
moves to each new step, and motion stops under reduced motion.
… sections

The hero now reads "The number one platform for" with the last words
cycling, and the try-it panel replaces the single question. New sections
after the courses story cover the three kinds of lab and the desktop app
that runs the shell labs, with links to download it.
The words after "The #1 platform for" are now typed out, held and
deleted with a blinking cursor instead of sliding in. With reduced
motion they swap whole, with no typing and no cursor.
It used to stop after two rounds, which was easy to miss. It now runs
six rounds, pauses while scrolled away or under a mouse, and no longer
pauses on a tap.
The headline fits "The #1 platform for" on one line, the hero spacing
and Dot are smaller so the first question shows on the first screen,
the step list is one swipeable row that keeps the current step in view,
and the new step scrolls into view after Next. The keyboard tip is
hidden on touch screens, and the lab cards fit three across sooner.
Visitors are short on time, so each step gets one try. A wrong answer
marks the right one with the reason, a wrong order is put right on
screen, and Next appears either way. The Linux lab gets a Run it for
me button and both labs can be skipped; any finished visual lab run
opens the next step.
@ZeeshanAdilButt
ZeeshanAdilButt merged commit 674ac14 into main Nov 18, 2026
3 checks passed
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.

1 participant