Devlog 7: Finally out.

I published it onto a github. The FULL code is currently privated, as I am not allowed to publish real game assets. Hopefully I wont get a DMCA or anything haha.

Things done this update:

• Just worked on bugs. Slopes were rendered weird, there were lots of issues with the menus or levels not loading.
• Optimizations: Since I finally released a working version, it now runs completely in browser. I use a macbook pro m2 pro, so it does run very well, but it should run really well on lower end devices as well.

The End?

• No, this is not the end. I think I will keep working on this project. This has been a dream project for a while…

Future updates:

• Better icon system. Currently its a little weird picking colors.
• Online level support? Maybe being able to import .GDshare files? Not too sure yet..
• And lastly, more bug fixing :)

Thank you to everyone liking and reposting this project. It really took me a long time to figure out, and I hope everyone enjoys it as much as me and my friends.

Devlog 6: comparing everything against the real game

I spent this stretch going through the port and comparing it to the real game, using recordings and dumps from the actual game instead of eyeballing it. Found a lot of small stuff that was wrong. sadly they updated the game, and i am NOT trying to put in more items. it will be added later…

Fixed this time:

• Spider ceiling. If there was nothing above the spider, it flew up to y 1500 and left the level. That was the glitching through levels thing. It now stops at the same kind of ceiling the ball has.

• Dash camera. The zoom was getting applied twice, so zoomed sections were drawn shifted. I checked it against a screenshot from the real game and it lines up now. The camera also flips its follow margins when gravity is flipped, like the real one, and it no longer starts 90 units too high. Compared to a full real run of Dash it’s off by about 2 units on average now (it was around 68).

• Monsters and the black sludge in Fingerdash and Geometrical Dominator are actually deadly now. The port drew them but never collided with them.

• The sludge animates properly and the little balls on top of rods show up and pulse with the music.

• Draw order for a bunch of the 2.2 decorations was wrong, mostly in Dash.

• Swing portal hitbox fixed, and a missing audio file no longer throws. (still kinda buggy but this gamemode sucks anyways lol)

Not fixed:

• Some levels have different background colors than the real game. I think my reference screenshots are bad for those, so I need to record the game live to find out.
• Dash camera is still off in the rotating section, the spider part, and the end climb.
• Dual camera height, and the pit sprites (not sure if they animate).
• Nothing’s pushed yet.

Whats next:

• I am planning to get A WORKING VERSION BEFORE STARDANCE CLOSES. Meaning, I have two days to get bugs fixed, and a working website. might host it on my little jetson nano)

• Dash camera leftovers

• Get Geode working again so I can record the real game

• and ofcourse, More bug hunting

I am working on bug fixes. Robot is finally complete, dual is ALMOST there, most levels are possible.

I still need to fix the deadlocked wave, some weird block placements, audio glitches, and im pretty sure those are the last bugs.

github link and demo are NOT out yet, as I need to figure out how to publish this without robtop suing me…

We are getting close. Stay tuned.

a lot has been changed. We have finally figured out the ui, MOST gamemodes, most menus. i am working on the last assignments and planning to release THIS WEEK. stay tuned.

its beginning to feel like the real thing.

— sorry for this short devlog, next one will include all information. im trying to push out as much as i can.

Devlog 3: physics and bugs

I only worked on physics and bugs for the last 2 days since the last devlog. I’ve got recordings of the real game playing every level, so I replay the same inputs in my port and count every spot where the player ends up somewhere different. That number went from 333 → 30.

(its not perfect, but its getting close.)

No more guessing numbers luckily, i got some real data.

Fixed this time

• Force blocks, and the 3 other blocks. These were important, they shouldnt be rendered at all but they have a huge purpose.
• The 2.2 End trigger. the level ends at the correct place now.
• Rotate Gameplay speed hand-off, teleport gravity, linked teleports. (kinda works but i need to fix)
• Dash orbs, spider orbs, wave hitboxes, saw hitboxes.
• Ship/UFO getting pushed around by moving blocks (mainly for deadlocked.

The bot beats all 22 levels but I cannot finish the levels. i might need to retrain the bot for it to not glitch through the maps

wait i might get the bot to use actual game macros to test… ok

Next

• fix robot as its terrible rn
• more physics stuff
• gamemodes
• dual is terrible right now
• fix the bot so it can really test
• optimizations
• bug hunting with my friends

Devlog 3: physics and bugs

I only worked on physics and bugs for the last 2 days since the last devlog. I’ve got recordings of the real game playing every level, so I replay the same inputs in my port and count every spot where the player ends up somewhere different. That number went from 333 → 30.

(its not perfect, but its getting close.)

No more guessing numbers luckily, i got some real data.

Fixed this time

• Force blocks, and the 3 other blocks. These were important, they shouldnt be rendered at all but they have a huge purpose.
• The 2.2 End trigger. the level ends at the correct place now.
• Rotate Gameplay speed hand-off, teleport gravity, linked teleports. (kinda works but i need to fix)
• Dash orbs, spider orbs, wave hitboxes, saw hitboxes.
• Ship/UFO getting pushed around by moving blocks (mainly for deadlocked.

The bot beats all 22 levels but I cannot finish the levels. i might need to retrain the bot for it to not glitch through the maps

wait i might get the bot to use actual game macros to test… ok

Next

• fix robot as its terrible rn
• more physics stuff
• gamemodes
• dual is terrible right now
• fix the bot so it can really test
• optimizations
• bug hunting with my friends

a lot has been changed. We have finally figured out the ui, MOST gamemodes, most menus. i am working on the last assignments and planning to release THIS WEEK. stay tuned.

its beginning to feel like the real thing.

— sorry for this short devlog, next one will include all information. im trying to push out as much as i can.

Devlog 2: Menus, Triggers, and Proper Animations

Time spent since last devlog: ~10h 10m
Total time logged: ~32h 53m

The levels aren’t finished yet, but the game is finally starting to look and feel like actual Geometry Dash instead of a static test build.

Visuals & Triggers

The levels were way too stiff before. Adding authored trigger behavior makes everything move and pulse like the real game:

• Pulse & Color Triggers: Added live HSV shifts and over a thousand pulse triggers so backgrounds, objects, and channels flash to the beat properly.
• Movement & Easing: Implemented real easing curves (including overshooting) and move stacking so platforms follow the player smoothly instead of jittering.
• Rotate Triggers: Objects and hazards actually spin around pivot points instead of sitting frozen in place.
• Mirror Portals: The entire camera flips cleanly now without breaking the screen layout. (no animation for flip yet WILL BE ADDED NEXT)
• most of this works OKAY, but there are still lots of changes to be made.

The UI Overhaul

The game now boots into a real main menu. The setting, icon menu, pause menu, and win screen were rebuilt from scratch using original assets and binary-accurate layouts:

• Game Feel: Button press animations, proper hitboxes (almost), snappy sliders, and difficulty badges match the real thing (except for dash for some reason).
• Icon Menu: Swapped out the old sprite sheet for the individual 2.2 sheets. All 107 palette colors and hundreds of icons are loaded in and selectable. (not formatted well rn)
• HUD: Practice mode buttons, pause screens, and attempt counters scroll away naturally instead of cluttering the view.

Next Up

• Finishing all levels
• bug testing
• optimizing everything
• more bug testing

More devlogs coming soon

Devlog 1: I’m Porting Geometry Dash to the Web

I have over 300 hours in GD and beat my first Extreme Demon a few weeks ago.

Total time logged: ~22h 30m

I forgot about devlogs even though I’ve been working on this for weeks.

This is not a wrapper. No Unity, no Godot, no emulator, and none of the love.js stuff I used for my Balatro port. It’s vanilla TypeScript + WebGL2, reading the real level files directly out of my Steam copy and re-implementing GD’s physics, collision, gamemodes, triggers, and rendering entirely by hand.

My plan for now is just to build the 22 classic main levels, the menus, and the icon kit. No editor, no online, and no platformer mode for now, though I do want to add custom levels later (possibly supporting .gmd imports via the Geode “GDShare” mod).

What Works So Far

• Rendering: All 22 levels render somewhat correctly.
• Gamemodes: All 8 modes are implemented (Cube, Ship, Ball, UFO, Wave, Robot, Spider, Swing), though only 4 feel solid right now.
• Mechanics: Portals, orbs, pads, breakable blocks, and dual mode (barely working).
• Triggers: Color, Move, Alpha, Toggle, Spawn, and Shake.
• Features: Practice mode, checkpoints, secret coins, and save states.
• UI & Audio: Level select, icon kit, settings, music, SFX, and pause menu.
• VFX: Particles, screen shake, and death explosions.

The Actual Hard Part

Rendering was the easy part. Making it feel right is the entire project. While other GD web remakes exist, almost none of them nail the physics.

I ended up disassembling the actual game binary with Claude to read the original physics values and logic directly.

Next Up

• Finishing the last 3 levels
• Robot and Spider animations
• Proper easing on moving platforms
• Overhauling the main menu
• Deploying to a real domain so people can play it
• General bug fixes (there are a lot right now)

More devlogs coming soon!

Devlog 2: Menus, Triggers, and Proper Animations

Time spent since last devlog: ~10h 10m
Total time logged: ~32h 53m

The levels aren’t finished yet, but the game is finally starting to look and feel like actual Geometry Dash instead of a static test build.

Visuals & Triggers

The levels were way too stiff before. Adding authored trigger behavior makes everything move and pulse like the real game:

• Pulse & Color Triggers: Added live HSV shifts and over a thousand pulse triggers so backgrounds, objects, and channels flash to the beat properly.
• Movement & Easing: Implemented real easing curves (including overshooting) and move stacking so platforms follow the player smoothly instead of jittering.
• Rotate Triggers: Objects and hazards actually spin around pivot points instead of sitting frozen in place.
• Mirror Portals: The entire camera flips cleanly now without breaking the screen layout. (no animation for flip yet WILL BE ADDED NEXT)
• most of this works OKAY, but there are still lots of changes to be made.

The UI Overhaul

The game now boots into a real main menu. The setting, icon menu, pause menu, and win screen were rebuilt from scratch using original assets and binary-accurate layouts:

• Game Feel: Button press animations, proper hitboxes (almost), snappy sliders, and difficulty badges match the real thing (except for dash for some reason).
• Icon Menu: Swapped out the old sprite sheet for the individual 2.2 sheets. All 107 palette colors and hundreds of icons are loaded in and selectable. (not formatted well rn)
• HUD: Practice mode buttons, pause screens, and attempt counters scroll away naturally instead of cluttering the view.

Next Up

• Finishing all levels
• bug testing
• optimizing everything
• more bug testing

More devlogs coming soon

Devlog 1: I’m Porting Geometry Dash to the Web

I have over 300 hours in GD and beat my first Extreme Demon a few weeks ago.

Total time logged: ~22h 30m

I forgot about devlogs even though I’ve been working on this for weeks.

This is not a wrapper. No Unity, no Godot, no emulator, and none of the love.js stuff I used for my Balatro port. It’s vanilla TypeScript + WebGL2, reading the real level files directly out of my Steam copy and re-implementing GD’s physics, collision, gamemodes, triggers, and rendering entirely by hand.

My plan for now is just to build the 22 classic main levels, the menus, and the icon kit. No editor, no online, and no platformer mode for now, though I do want to add custom levels later (possibly supporting .gmd imports via the Geode “GDShare” mod).

What Works So Far

• Rendering: All 22 levels render somewhat correctly.
• Gamemodes: All 8 modes are implemented (Cube, Ship, Ball, UFO, Wave, Robot, Spider, Swing), though only 4 feel solid right now.
• Mechanics: Portals, orbs, pads, breakable blocks, and dual mode (barely working).
• Triggers: Color, Move, Alpha, Toggle, Spawn, and Shake.
• Features: Practice mode, checkpoints, secret coins, and save states.
• UI & Audio: Level select, icon kit, settings, music, SFX, and pause menu.
• VFX: Particles, screen shake, and death explosions.

The Actual Hard Part

Rendering was the easy part. Making it feel right is the entire project. While other GD web remakes exist, almost none of them nail the physics.

I ended up disassembling the actual game binary with Claude to read the original physics values and logic directly.

Next Up

• Finishing the last 3 levels
• Robot and Spider animations
• Proper easing on moving platforms
• Overhauling the main menu
• Deploying to a real domain so people can play it
• General bug fixes (there are a lot right now)

More devlogs coming soon!

devlog v0.6.0

~1 hour and 28minutes logged

i finally admitted to myself that the thing i was building was basically monkeytype with extra steps and a guilt trip attached. wpm counters, accuracy tracking, quote banks… all of it made the extension feel like a typing test. and the last thing i need when im opening youtube for the 40th time today is to feel like im being graded. the “productivity” version of this extension was stressing me out more than the doomscrolling was. so i deleted the whole concept and started over.

what sucked

• the css pollution bug. outube and twitter kept leaking their styles into the overlay and centering was broken on like half the sites. it filled up the website console and it sucked to fix.
• found out the scroll lock used a :has(.fade-out) selector, which breaks if the site itself has any element with the class fade-out.
• the google fonts import just straight up does not load on x.com because of csp.
• the drift-up animation on the dissolving letters didnt work at all. css transforms dont apply to inline elements so the text was just fading in place this whole time and i thought it was drifting.
• there was also a random prime number sieve running on every single page load. no clue

The Epiphany

the epiphany was: stop measuring. the typing test framing WAS the problem. the extension is supposed to make you go outside.

so now its just a blank void that asks “what’s making your mind busy right now?” and everything i type dissolves 1.5 seconds later. Just 50 characters

so thats it i think

what actually got built

• free-form canvas. zero quotes, zero wpm, zero accuracy, zero scores
• dissolving text engine — every char fades + blurs + drifts away exactly 1.5s after typing, and each char gets its own random drift vector so the text scatters like ash instead of disappearing as a block.
• invisible-ish 50 char threshold, then the whole overlay melts (fade + scale + unblur) and lets me back in
• full shadow dom isolation — closed root + a constructable stylesheet, which apparently is immune to page csp?? so host sites cant touch the overlay anymore. not youtube, not twitter
• roboto mono bundled INSIDE the extension (latin, latin-ext, cyrillic — yes cyrillic, i type in more than one language) so csp and offline cant hurt me anymore
• kept the breathing intro but its 6s now and any key skips it. and the skip key actually types itself instead of being eaten
• capture-phase key handling so youtube shortcuts dont fire behind the overlay while i type (no more accidental video pausing mid-vent)
• an actual working scroll lock this time
• reduced-motion support because accessibility is not optional
• removed the prime sieve. again. dont want to talk about it
  done with this project

maybe one day ill keep working on it. release a 1.0.0…

Devlog 1: I actually ported Balatro to the web…

Total time logged: ~3h 15m (hackatime wasn’t working because I was on windows today instead of linux, but I put in around 2 hours that werent logged)

Not gonna lie, this was way harder than I thought it would be. But the base web port of Balatro is officially working!

It took over 3 hours of dealing with random compilation errors, broken shaders, and browser crashes, but it runs insanely smooth now. Here is everything that went down to get it working.

i hope i dont get sued or anything cuz i posted the straight files, i will probably add some thing where you can import your game files and then it makes a webport

also, there is no website to play yet, thats coming next.

The stuff that broke (and how I fixed it)

1. WebGL and Shaders acting up

Balatro uses a ton of shaders for card effects, dissolves, and holographic stuff. Browsers are super picky about WebGL compared to desktop:

• Fixed loop issues in hologram.fs so the browser wouldn’t just crash when rendering cards.
• Fixed texture scaling issues so cards wouldn’t render as solid black rectangles.

2. Making saves actually save

In the browser, local file saves wipe as soon as you close the tab. That obviously sucked for a rogue-like game, so I fixed it:

• Forced love.js to use a fixed save folder name (Balatro).
• Made it automatically sync saves to the browser’s IndexedDB every 15 seconds and whenever you switch tabs. So now your run saves even if you refresh or close the tab.

3. Mobile touch controls

Playing on a phone was annoying at first because touching the screen made the browser zoom in or scroll the page.

• Blocked double-tap zooming, page scrolling, and pull-to-refresh gestures.
• Touches now map accurately directly to the cards and buttons.

4. The booster pack freeze bug

This was easily the worst bug. Opening a booster pack would completely freeze the entire tab with zero error messages in the console.
Turns out the game was getting stuck in an infinite loop while trying to generate cards for the pack view. Refactored the pack generation logic to yield frames properly, and now packs open instantly.

5. Build script and github setup

• Wrote a custom Python script (tools/build.py) so I can audit, patch, and build the whole web version with one terminal command.
• Set up Git LFS so heavy game files don’t bloat the git history.
• Added a GitHub Actions workflow to auto-deploy to GitHub Pages whenever I push code.

Current Status

• Base Web Port: Fully working
• Shader Fixes: Done
• Save Files: Working and persistent
• Mobile Support: Good to go
• Auto Deployment: Set up

What’s Next

Now that the actual game runs, the next goal is making mods work.

1. Injecting Steamodded into the web build so it can load custom Lua mods.
2. Adding an “Import Mod” button on the webpage so you can drag and drop mod files right into the game.
3. posting on website, will get a domain.
4. OPTIMIZATIONS! very important

(my devlogs look better too)

Another hour of coding today, and it led to a massive realization.

The 0.5.0 Wall (And Why It Sucked)

I spent today’s session trying to fine tune the “Zen Governor” speed penalty and fixing the text wrapping bugs. While the words are wrapping better now, actually using the extension felt terrible. I type pretty fast, and using my own extension was making me so mad that I wanted to stop working on it.

the screenshot I attached shows what the penalty was. basically, if you started writing too fast, it would add MORE to the poem. and it sucked. i tried playing around with the characters per minute timings but its just not very reliable and hard to perfect.

If a mindfulness app makes you want to punch your keyboard, you’ve built the wrong app.

the Epiphany

The whole typing-test framework is inherently stressful. If the app is tracking your typos, grading your accuracy, and monitoring your speed, your brain stays stuck in “performance mode.” You arent relaxing, youre just playing this game of “type as fast as you can”. while its fun to type fast, its not the point of this project.

So, I’m throwing the whole typing exam mechanic in the trash.

The Next Step: The “Brain Dump” Overhaul (v0.6.0)

For the next version, we are pivoting to something that actually feels therapeutic:

• Free-form Canvas: No more copying quotes perfectly. No more “incorrect” keys or rigid typing checks. You get an empty screen that asks: What’s making your mind busy right now?
• Dissolving Text: You type whatever raw thoughts are in your head. Exactly 1.5 seconds after you type a letter, it will smoothly fade, blur, and drift away into nothingness. Your stressful thoughts literally disappear from the screen.
• No Performance Metrics: Goodbye WPM, goodbye accuracy tracking. Just a simple counter showing you’ve let go of 50 characters. Once you type 50 characters of a raw brain dump, the overlay fades out, and the site unlocks.
• hopefully this 5.0 release will be the LAST, as this project is getting a little boring to work on…

This completely gets rid of the annoying spacing and indexing bugs too, because the browser can just handle normal text input natively. Time to rebuild this into something that actually brings some peace.

Well. I just spent 2 hours on the newest version. And for what…

This is the official 0.4.0 release.

It’s been a bit since my last devlog, and a lot has happened behind the scenes to finally bridge the gap between project and final extension. unfortunately, this is not the final.

First, a quick reality check on the layout. In my last post, I said the text was perfectly centered. It was… on my blank HTML test page. But the second I actually started testing the extension on live websites like YouTube and Twitter, their styles completely leaked into my code and broke it. So ye, the centering is currently broken but ill fix it one day. maybe

Here is a quick list of everything I actually changed and built since the last log:

It actually unlocks the page now: Once you finish typing the very last letter, the overlay just fades away. pretty simple for now, i might make it like a melting effect? not sure yet

• Bolder text & a clean new font: Like I said in the last post, the old text was way too small and thin. I cranked it up to 34px, made it a lot bolder, and switched it to Google’s ‘Roboto Mono’ font so it looks way niccer.
• Multi-line poems: You can type through short stanzas now instead of just flat, one-line quotes. I completely broke the extension at first because the cursor kept getting stuck on the invisible line-break characters \n, but I fixed the logic so it jumps lines.
• Escape to restart: Added a quick reset feature. Hitting the Escape key wipes your current progress and pulls up a fresh random quote.

The Plan

The code works well and everything feels incredibly smooth, but this 0.4.0 update is officially a halfway point and a place to rebuild.

After staring at the live WPM and accuracy counters ticking up while I was testing it, I asked my dad how it looked. He made me realize that I am literaly building the exact opposite of what I actually want.

The whole points of this Grounding project is to be a relaxing speed bump that encourages you to take a breath and get off your device. But by adding speed metrics and accuracy, I literally just cloned Monkeytype.
instead of calming your brain, i filled it with the dopamine hit like any game. you just want to get back to your social media even FASTER.

but what is next: For the next update, im making a big change. I am stripping away the stress metrics (byeWPM and accuracy) and shifting toward a more mindful experience. I am going to look into organic, calming color palettes and maybe even a mechanic that forces you to ‘slow down’ rather than type fast. Like, maybe if you type too fast, it generates more text for you to slow you down. Not really sure yet, but the speed type era is officially over.

i also learnedd more markdown so from now on my dev logs will look better.

huge update for grounding today.

first off, i fixed the layout issues from the last post. the text is finally centered on the screen and actually readable against the dark background.

but the biggest change is that the typing mechanic is officially here.
I shifted the text rendering to individual character spans so i could track keyboard inputs character by character. it completely mirrors the monkeytype feel now.

How it looks so far:

• characters start out a muted gray
• typing a correct key turns it a smooth offwhite
• typos turn a soft red
• i also got the custom caret (cursor) working.

it has a decent transition so it slides smoothly between letters instead of just snapping rigidly, and it flashes slowly when you stop typing (the animation is still going to be worked on cuz its not the best). backspace support is fully functional too, so you can actually go backward and correct your mistakes.

now, what’s next:

• making the overlay fade out beautifully once the quote is 100% complete
• also might make the text larger and bolder; its hard to read
• actually unlocking the restricted website after you finish typing
• expanding the quote pool with some longer, cleaner poems/quotes (i might try to get the quotes from some bank, not sure yet.)

Added some placeholder quotes. I have it randomly choose from a list of quotes that then displays on the overlay. Next update will make the text EASIER to see, and also i will add the ability to type and get into the social media. also its off center and ill fix that.

Finally started the extension. Googles docs for creating extensions is amazing, theres a full guide. i matched the coloring from MonkeyType, because thats where my inspiration comes from.

First devlog. Created the files, and created some small text to see how all of the work would turn out. Looks great so far.

Features to add:

1. Poems to auto show.
2. Compatible with more websites.
3. add the actual typing animations and everything
   4, clean up the code cuz its messy