Micah Winesberry's site: a classic portfolio, plus a small platformer at /play. The live site is served from https://blue5gd.github.io/Portfolio/, so every local URL also starts with /Portfolio/.
npm install
npm run devOpen http://localhost:4321/Portfolio/.
npm run build writes the site into dist/. npm run preview serves that build the same way GitHub Pages will, still under /Portfolio/.
Pushing to master deploys the live site. Don't push unless you mean to publish.
All of the text lives in src/data/. Classic mode and the game both read those files. Change a fact there and both update. Lists are newest first, except Featured, which stays in the order already in src/data/featured.ts.
/play opens a level select. Beating a level with Practice off marks it cleared. Finishing with Practice on marks it practice completed. Skip marks it skipped. Any of those three unlocks the next level. Only a normal clear counts as cleared. That progress is saved in the browser under the key b5gd:progress. The mute button is saved under b5gd:muted. The volume slider is saved under b5gd:volume.
The game needs a keyboard. On a phone, or in a window narrower than 768px, Play is hidden and a note points back to the classic page. On-screen buttons are a possible later feature. They are not built.
Practice mode is a button in the corner of a level. Turn it on, then press Z to drop a checkpoint where the cube is, and X to remove the last one you dropped. A crash sends you back to that checkpoint. Turn Practice off and you use the level's own checkpoints again.
All six courses are in src/game/levels.ts: First Level, Lost World, Mystic Mountains, Sci-Fi Showdown, Last Hope, and The Final Battle. Each string in rows is one row of the map. Row 0 is the top. Every row in a level must be the same length. The comment above each course says what is in it.
. empty # block ~ ice = one-way platform
^ v < > spikes (floor, ceiling, left, right)
P start C checkpoint I info block J jump pad O end portal
! falling spike x crumble o jump orb
| vertical laser - horizontal laser
A ! hangs until the cube enters that column, then it falls. It stays dangerous where it lands until you respawn. An x is solid until you have stood on it for a moment. It cracks, then falls. The hole under it is what hurts you.
An o is a ring. Touching it does nothing. Press jump while the cube overlaps it and it launches you, higher than a normal jump and lower than a pad. Letting go of jump does not change that height. Walk out of the ring and it can launch you again.
| and - are lasers. A straight run of the same character is one beam. Every beam in a level shares one timer: off for 0.7 seconds, then on for 1.1 seconds. The beam only hurts you while it is on. Respawning restarts the timer at the start of the off time, so you do not appear inside a beam.
A moving platform is not a letter in the map. It is listed under movers. It is a single solid tile that goes out and comes back. Standing on it carries the cube. When the cube respawns, the platform snaps back to where it started. Mystic Mountains has one. Sci-Fi Showdown has two: one that slides sideways, and one that moves up and down.
An I tile opens a panel. On First Level those panels are About, then the three Featured items, in that order. On Lost World they are the three projects, newest first. On Mystic Mountains they are Science Olympiad, Mu Alpha Theta, Chess, and then Service. On Sci-Fi Showdown they are CourseTable, then Catalyst. On Last Hope they are the awards, newest first, split into three panels. On The Final Battle they are Skills, Education, and Contact. The words come from src/data. The game does not keep a second copy.
Last Hope gets darker as you move right. The last part of that course turns the floor edge and the spikes red so you can still read them. The Final Battle stays dark except for a circle of light around the cube. Its saws are listed under movers, the same way platforms are.
Warmup is still in src/game/levels.ts, but it is not on the level select. It is the old sandbox map (ice, jump pads, one-way platforms, wall spikes). It is not Practice mode. Practice mode is the Z and X checkpoints described above.
Each level plays one looping song from public/audio/. The file name, artist, and source link for each song are on its course in src/game/levels.ts, and the "Music credits" button on the level select lists them. src/game/audio.ts plays them: the song keeps going when you crash, when an info panel opens, and while the level-clear panel is up. It pauses if you open the pause menu, and it stops when you leave the level. The Volume slider on the level select and in the game sets how loud it is. If a file is missing, that level runs silently.
The original downloads sit in docs/plan-assets/ and are ignored by git, so only the renamed copies in public/audio/ get committed.
You are responsible for getting permission, or confirming each artist's usage terms, before deploying these songs on the public site.