5 ms·

Show HN: I built a small browser engine from scratch in C++

146 points by crediblejhj 9mo ago

Hi HN! Korean high school senior here, about to start CS in college. I built a browser engine from scratch in C++ to understand how browsers work. First time using C++, 8 weeks of development, lots of debugging—but it works! Features: - HTML parsing with error correction - CSS cascade and inheritance - Block/inline layout engine - Async image loading + caching - Link navigation + history Hardest parts: - String parsing(html, css) - Rendering - Image Caching & Layout Reflowing What I learned (beyond code): - Systematic debugging is crucial - Ship with known bugs rather than chase perfection - The Power of "Why?" ~3,000 lines of C++17/Qt6. Would love feedback on code architecture and C++ best practices! GitHub: https://github.com/beginner-jhj/mini_browser https://github.com/beginner-jhj/mini_browser

deleted 9mo ago
[deleted]
xacky 9mo ago
I follow a lot of the alternate browser engines and am always looking for new ones outside of the big three. You should use your experience to get a career in the browser tech world as we are dangerously close to the Chromium only web.
- skybrian 9mo ago
  I think this is cool as long as you don't use it to do your banking, and it needs to be running in a VM or on a Raspberry Pi or something. The Internet is dangerous. Something something don't write your own crypto. Also, there's a big difference between running a handmade browser that I wrote and trusting one that some stranger wrote. I guess I'm going to have to try writing my own someday :-)
noo_u 9mo ago
This is a really awesome project! If you have time/interest, you could try to build a simple http server now, that your browser could communicate with. Then you could try to implement a simple version of TCP/IP, and look into how lower level networking works. Great job!
- rustyhancock 9mo ago
  The real full stack engineering
  - ge96 9mo ago
    But did they make their own CPU?
    - aruametello 9mo ago
      ... did they mine their own minerals? this could go into a sagan's "If you wish to make an apple pie from scratch, you must first invent the universe."
      - HPsquared 9mo ago
        And ideally use your own philosophy, concepts and language when engineering everything. No English language, Latin alphabet or Arabic numerals!
      - Novosell 9mo ago
        Like any self-respecting baker, I have a cabinet full of universes which produce various pies.
- zabzonk 9mo ago
  In my experience, not a good idea to write both the client and the server for a given protocol which use each other. Far too easy to misunderstand the protocol. I remember doing this for a training course I wrote for OLE (later COM) years ago. The client and the server worked perfectly together, just not with correctly implemented OLE clients and servers.
  - snerbles 9mo ago
    Just slap a new legally-distinct-but-still-confusing name on your client/server pair, and use it as a marketing tool to sucker in purchasing managers. Like EtherNet/IP, where the IP somehow stands for "Industrial Protocol".
luskira 9mo ago
this is so cool man congrats!
lifetimerubyist 9mo ago
Cursor is a 30 billion dollar corporation that couldn’t do this with practically unlimited compute for their AI. Well done.
lasgawe 9mo ago
This is one of the hardest projects of its kind. Congrats! looks cool.
grougnax 9mo ago
This might be the hardest thing ever in computer science, kudos!
- solusipse 9mo ago
  lol
samiv 9mo ago
Since when does homework feature on the front page of HN? I find this very odd...
- antirez 9mo ago
  Probably more complex project than projects 99% of what software developers with a real job do daily.
  - deleted 9mo ago
    [deleted]
  - Imustaskforhelp 9mo ago
    The fact that literally the Creator behind Redis has to go and point this out straight up proves this. Also Antirez, I am in high school and I can literally write it in writing that there's literally no school with such homework assignments imo. I have written a comment about seeing the curriculum of one of my other friends and my anecdotal evidence talking to friends. There's literally zero doubt in my mind that there's no such homework assignment.
- _vqpz 9mo ago
  Nowhere in the post does OP say this is a homework assignment. All they said was that they are a high school senior.
- dag11 9mo ago
  What high school CS class (or even college class) is assigning a project to implement a minimal web renderer? This is super impressive.
  - Imustaskforhelp 9mo ago
    I am in High school & in my school for some reason CS isn't taught but I still taught one of my friends CS from my tuition you can say. I looked at his book and wanted to teach him python. You can say its senior high school and what I taught him was what keywords mean in python and operators mean in python etc. A lot of it was just semantic. Could be the fact that it was first chapter and he came to me when his exam was just some few days later. I swear but the hardest thing I observed in that book was probably some SQL from what I heard or maybe some minor Java or the fact that it had file access within python or atleast that's what I observed. The OP's comments are clearly weird and feel like something which should be ignored. This project is really really cool imo. (Heck I was trying out literally the same thing too but over golang out of curiosity but really didn't land anywhere and the fact that the creator of this was able to still is pretty impressive even if they used LLM or not!, on which I haven't felt any clarification but I just wanted to point how both are really really cool!)
pipeline_peak 9mo ago
We need more projects like this. People making all sorts of libraries for HTML/CSS parsers, render trees, layout models etc. I don’t want to see a world where everything runs on top of Chromium and we all just unwittingly submit to it.
quentindanjou 9mo ago
How much was coded with an LLM and how much do you understand?
- forgotpwd16 9mo ago
  Excluding recent refactor commits code seems to be handwritten, maybe lightly AI-assisted.
  - FEELmyAGI 9mo ago
    Based on what? In fact, the commit messages sure make it seem like someone who only knows how to use git to to take snapshots, exactly like when one turns off their brain and vibe codes, and after chatting enough with the chatbot to get their next feature seemingly to work make some sort of "updated bla" commit with no reference to the extremely detailed code change they just made. https://github.com/beginner-jhj/mini_browser/commits/main/ https://github.com/beginner-jhj/mini_browser/commits/main/
    - forgotpwd16 9mo ago
      You seem to have gotten used to perfect written commit messages by Claude. Many people, especially those starting out with, or not heavily using, git, do write messages like that. (edit: To be honest sometimes I too make temporary "wtf" commits; I just later squash them and no one knows.) That can actually be seen in this very repo by the refactor ones. And, the commits themselves are actually where I'm basing it. Small changes (vibe coders tend to forget a vcs exists; why we see 20k LOC first commits), commented-out code parts (have you ever seen AI commenting out code?), plain code comments (again compare to what refactor commits introduce).
      - deleted 9mo ago
        [deleted]
  - quentindanjou 9mo ago
    I am not sure on what you are basing this. Even the post itself looks written by an LLM. I might be wrong, things are always evolving and it is going to be more and more difficult to spot. But I was genuinely asking OP, and I don't have the intention of undermining their achievement! (it stays cool even with use of LLM)
vintagedave 9mo ago
> I had to implement recursion, which I wasn't familiar with. The amount of learning this person has done is incredible. Kudos. I also appreciated seeing they used AI and tutorials yet fixed bugs themselves, as a way to demonstrate they understood I the code.
- deleted 9mo ago
  [deleted]
olliem36 9mo ago
Did you use GPT 5.2 Codex? lol
butz 9mo ago
Good job! You should consider contributing to a similar small browser - Dillo @ https://dillo-browser.org/ https://dillo-browser.org/ , and help to build a complete tiny browser.
robshippr 9mo ago
Incredible job here. Really took a lot of work to get this done. Keep it up.
deleted 9mo ago
[deleted]
userbinator 9mo ago
Interesting to see everyone seemingly writing their own browser lately. Ironic to think that AI assistance, from Google itself, might be what ends up breaking their browser monopoly. (Speaking as someone who also started writing my own long ago, and it's far from complete.)
- einpoklum 9mo ago
  > everyone seemingly writing their own browser lately Can you name/link to a few examples? I know about Ladybird: https://github.com/LadybirdBrowser/ladybird/ https://github.com/LadybirdBrowser/ladybird/ but haven't noticed other initiatives. > might be what ends up breaking their browser monopoly. This post is a toy project, not a full-fledged browser engine, which is a large beast (even when you _don't_ do everything from scratch)
  - userbinator 9mo ago
    Look around HN, there have been a few already.
  - zamadatix 9mo ago
    I think the one that made the biggest news cycle splash this last month was the FastRender experiment https://github.com/wilsonzlin/fastrender https://github.com/wilsonzlin/fastrender from Cursor, but I've also seen some others posted this last month. Simonw's blog seems to be tracking some under the browser-challenge tag https://simonwillison.net/tags/browser-challenge/ https://simonwillison.net/tags/browser-challenge/ such as one-agent-one-browser and HiWave.
Imustaskforhelp 9mo ago
Indian high school senior here about to start CS in college here. Your project feels phenomenal. Definitely starred. I was actually trying to create a browser (in golang) myself as well (using LLM assistance) & I really couldn't do it after countless efforts. https://github.com/SerJaimeLannister/golang-browser https://github.com/SerJaimeLannister/golang-browser Much of it was just curiosity towards if LLM's could port the rust project by emsh https://emsh.cat/one-human-one-agent-one-browser/ https://emsh.cat/one-human-one-agent-one-browser/ into golang & this has led to some really insightful discussions between me and emsh on bluesky This is actually really pretty cool as I was targeting a ~10k loc for golang from the ~20k loc of rust (given how golang has networking binaries and other stuff) I guess this is really cool. I was always really averse to C++ preferring golang. I think I am ken-thompson pilled for the most part lol. Anyways its really great to see people my age working in similar ideas. Somehow it gives us I guess a more sense of connection like I am not alone doing these things and I guess its pretty cool feeling seeing others do similar stuff and learning from them! I have starred your repo and good luck for college too man! Hope to communicate with ya. Edit: Another comment here as someone here mentioned that you used LLM, which LLM did you end up using and how'd you use it. For me personally, the most (success?) that I found which could generate a hackernews without any styles and anything was via their computer-use agent model (which I am thinking of downloading & working with kimi-cli to add more styling and other stuff as well in golang just out of curiosity) I don't really mind if you used LLM, but I am curious as to how in this instance.
- crediblejhj 9mo ago
  Hi there! I'm so glad to meet someone my age working on a similar path. Your project sounds really fascinating as well. To be honest, I wasn't familiar with the concept of "porting" until I looked it up through Gemini just now—it's such an interesting approach! You mentioned that you couldn't quite get it to work despite countless efforts, but I believe that only proves how incredibly difficult and ambitious your attempt was. During this project, I also faced constant failures and had to compromise on many things because of the sheer complexity. My engine doesn't support JS yet, and only handles a handful of CSS properties—and even those aren't perfect. But as people like us always do, we learn and grow through these failures. I truly hope you’ve gained a lot of growth and insight through your project as well. About LLMs: I used Claude. The key was using it as a mentor, not a code generator: -Asked WHY things work, not just HOW -Got help understanding concepts -Debugging assistance when stuck But I designed the architecture and solved problems myself. Thanks again for the star and your kind words! Let’s keep in touch and keep building.
_ache_ 9mo ago
Impressive. Kudos. You realise that it's only a toy implementation aimed at learning and not a full implementation. The parsing of HTML alone is way more complex than your actual implementation not mentioning at lot of things like the rendering or network (outsourced to Qt). Still a nice achievement that get you to understand why making a browser is a very complex task.
jonjacky 9mo ago
In addition to the code, the README here is exceptionally well done. It distinguishes this from many other learning projects.

146 points by crediblejhj 9mo ago

deleted 9mo ago

[deleted]

xacky 9mo ago

I follow a lot of the alternate browser engines and am always looking for new ones outside of the big three. You should use your experience to get a career in the browser tech world as we are dangerously close to the Chromium only web.

skybrian 9mo ago
I think this is cool as long as you don't use it to do your banking, and it needs to be running in a VM or on a Raspberry Pi or something. The Internet is dangerous. Something something don't write your own crypto. Also, there's a big difference between running a handmade browser that I wrote and trusting one that some stranger wrote. I guess I'm going to have to try writing my own someday :-)

noo_u 9mo ago

This is a really awesome project! If you have time/interest, you could try to build a simple http server now, that your browser could communicate with. Then you could try to implement a simple version of TCP/IP, and look into how lower level networking works. Great job!

rustyhancock 9mo ago
The real full stack engineering
- ge96 9mo ago
  But did they make their own CPU?
  - aruametello 9mo ago
    ... did they mine their own minerals? this could go into a sagan's "If you wish to make an apple pie from scratch, you must first invent the universe."
    - HPsquared 9mo ago
      And ideally use your own philosophy, concepts and language when engineering everything. No English language, Latin alphabet or Arabic numerals!
    - Novosell 9mo ago
      Like any self-respecting baker, I have a cabinet full of universes which produce various pies.
zabzonk 9mo ago
In my experience, not a good idea to write both the client and the server for a given protocol which use each other. Far too easy to misunderstand the protocol. I remember doing this for a training course I wrote for OLE (later COM) years ago. The client and the server worked perfectly together, just not with correctly implemented OLE clients and servers.
- snerbles 9mo ago
  Just slap a new legally-distinct-but-still-confusing name on your client/server pair, and use it as a marketing tool to sucker in purchasing managers. Like EtherNet/IP, where the IP somehow stands for "Industrial Protocol".

luskira 9mo ago

this is so cool man congrats!

lifetimerubyist 9mo ago

Cursor is a 30 billion dollar corporation that couldn’t do this with practically unlimited compute for their AI. Well done.

lasgawe 9mo ago

This is one of the hardest projects of its kind. Congrats! looks cool.

grougnax 9mo ago

This might be the hardest thing ever in computer science, kudos!

solusipse 9mo ago
lol

samiv 9mo ago

Since when does homework feature on the front page of HN? I find this very odd...

antirez 9mo ago
Probably more complex project than projects 99% of what software developers with a real job do daily.
- deleted 9mo ago
  [deleted]
- Imustaskforhelp 9mo ago
  The fact that literally the Creator behind Redis has to go and point this out straight up proves this. Also Antirez, I am in high school and I can literally write it in writing that there's literally no school with such homework assignments imo. I have written a comment about seeing the curriculum of one of my other friends and my anecdotal evidence talking to friends. There's literally zero doubt in my mind that there's no such homework assignment.
_vqpz 9mo ago
Nowhere in the post does OP say this is a homework assignment. All they said was that they are a high school senior.
dag11 9mo ago
What high school CS class (or even college class) is assigning a project to implement a minimal web renderer? This is super impressive.
- Imustaskforhelp 9mo ago
  I am in High school & in my school for some reason CS isn't taught but I still taught one of my friends CS from my tuition you can say. I looked at his book and wanted to teach him python. You can say its senior high school and what I taught him was what keywords mean in python and operators mean in python etc. A lot of it was just semantic. Could be the fact that it was first chapter and he came to me when his exam was just some few days later. I swear but the hardest thing I observed in that book was probably some SQL from what I heard or maybe some minor Java or the fact that it had file access within python or atleast that's what I observed. The OP's comments are clearly weird and feel like something which should be ignored. This project is really really cool imo. (Heck I was trying out literally the same thing too but over golang out of curiosity but really didn't land anywhere and the fact that the creator of this was able to still is pretty impressive even if they used LLM or not!, on which I haven't felt any clarification but I just wanted to point how both are really really cool!)

pipeline_peak 9mo ago

We need more projects like this. People making all sorts of libraries for HTML/CSS parsers, render trees, layout models etc. I don’t want to see a world where everything runs on top of Chromium and we all just unwittingly submit to it.

quentindanjou 9mo ago

How much was coded with an LLM and how much do you understand?

forgotpwd16 9mo ago
Excluding recent refactor commits code seems to be handwritten, maybe lightly AI-assisted.
- FEELmyAGI 9mo ago
  Based on what? In fact, the commit messages sure make it seem like someone who only knows how to use git to to take snapshots, exactly like when one turns off their brain and vibe codes, and after chatting enough with the chatbot to get their next feature seemingly to work make some sort of "updated bla" commit with no reference to the extremely detailed code change they just made. https://github.com/beginner-jhj/mini_browser/commits/main/ https://github.com/beginner-jhj/mini_browser/commits/main/
  - forgotpwd16 9mo ago
    You seem to have gotten used to perfect written commit messages by Claude. Many people, especially those starting out with, or not heavily using, git, do write messages like that. (edit: To be honest sometimes I too make temporary "wtf" commits; I just later squash them and no one knows.) That can actually be seen in this very repo by the refactor ones. And, the commits themselves are actually where I'm basing it. Small changes (vibe coders tend to forget a vcs exists; why we see 20k LOC first commits), commented-out code parts (have you ever seen AI commenting out code?), plain code comments (again compare to what refactor commits introduce).
    - deleted 9mo ago
      [deleted]
- quentindanjou 9mo ago
  I am not sure on what you are basing this. Even the post itself looks written by an LLM. I might be wrong, things are always evolving and it is going to be more and more difficult to spot. But I was genuinely asking OP, and I don't have the intention of undermining their achievement! (it stays cool even with use of LLM)

vintagedave 9mo ago

> I had to implement recursion, which I wasn't familiar with. The amount of learning this person has done is incredible. Kudos. I also appreciated seeing they used AI and tutorials yet fixed bugs themselves, as a way to demonstrate they understood I the code.

deleted 9mo ago
[deleted]

olliem36 9mo ago

Did you use GPT 5.2 Codex? lol

butz 9mo ago

Good job! You should consider contributing to a similar small browser - Dillo @ https://dillo-browser.org/ https://dillo-browser.org/ , and help to build a complete tiny browser.

robshippr 9mo ago

Incredible job here. Really took a lot of work to get this done. Keep it up.

deleted 9mo ago

[deleted]

userbinator 9mo ago

Interesting to see everyone seemingly writing their own browser lately. Ironic to think that AI assistance, from Google itself, might be what ends up breaking their browser monopoly. (Speaking as someone who also started writing my own long ago, and it's far from complete.)

einpoklum 9mo ago
> everyone seemingly writing their own browser lately Can you name/link to a few examples? I know about Ladybird: https://github.com/LadybirdBrowser/ladybird/ https://github.com/LadybirdBrowser/ladybird/ but haven't noticed other initiatives. > might be what ends up breaking their browser monopoly. This post is a toy project, not a full-fledged browser engine, which is a large beast (even when you _don't_ do everything from scratch)
- userbinator 9mo ago
  Look around HN, there have been a few already.
- zamadatix 9mo ago
  I think the one that made the biggest news cycle splash this last month was the FastRender experiment https://github.com/wilsonzlin/fastrender https://github.com/wilsonzlin/fastrender from Cursor, but I've also seen some others posted this last month. Simonw's blog seems to be tracking some under the browser-challenge tag https://simonwillison.net/tags/browser-challenge/ https://simonwillison.net/tags/browser-challenge/ such as one-agent-one-browser and HiWave.

Imustaskforhelp 9mo ago

Indian high school senior here about to start CS in college here. Your project feels phenomenal. Definitely starred. I was actually trying to create a browser (in golang) myself as well (using LLM assistance) & I really couldn't do it after countless efforts. https://github.com/SerJaimeLannister/golang-browser https://github.com/SerJaimeLannister/golang-browser Much of it was just curiosity towards if LLM's could port the rust project by emsh https://emsh.cat/one-human-one-agent-one-browser/ https://emsh.cat/one-human-one-agent-one-browser/ into golang & this has led to some really insightful discussions between me and emsh on bluesky This is actually really pretty cool as I was targeting a ~10k loc for golang from the ~20k loc of rust (given how golang has networking binaries and other stuff) I guess this is really cool. I was always really averse to C++ preferring golang. I think I am ken-thompson pilled for the most part lol. Anyways its really great to see people my age working in similar ideas. Somehow it gives us I guess a more sense of connection like I am not alone doing these things and I guess its pretty cool feeling seeing others do similar stuff and learning from them! I have starred your repo and good luck for college too man! Hope to communicate with ya. Edit: Another comment here as someone here mentioned that you used LLM, which LLM did you end up using and how'd you use it. For me personally, the most (success?) that I found which could generate a hackernews without any styles and anything was via their computer-use agent model (which I am thinking of downloading & working with kimi-cli to add more styling and other stuff as well in golang just out of curiosity) I don't really mind if you used LLM, but I am curious as to how in this instance.

crediblejhj 9mo ago
Hi there! I'm so glad to meet someone my age working on a similar path. Your project sounds really fascinating as well. To be honest, I wasn't familiar with the concept of "porting" until I looked it up through Gemini just now—it's such an interesting approach! You mentioned that you couldn't quite get it to work despite countless efforts, but I believe that only proves how incredibly difficult and ambitious your attempt was. During this project, I also faced constant failures and had to compromise on many things because of the sheer complexity. My engine doesn't support JS yet, and only handles a handful of CSS properties—and even those aren't perfect. But as people like us always do, we learn and grow through these failures. I truly hope you’ve gained a lot of growth and insight through your project as well. About LLMs: I used Claude. The key was using it as a mentor, not a code generator: -Asked WHY things work, not just HOW -Got help understanding concepts -Debugging assistance when stuck But I designed the architecture and solved problems myself. Thanks again for the star and your kind words! Let’s keep in touch and keep building.

_ache_ 9mo ago

Impressive. Kudos. You realise that it's only a toy implementation aimed at learning and not a full implementation. The parsing of HTML alone is way more complex than your actual implementation not mentioning at lot of things like the rendering or network (outsourced to Qt). Still a nice achievement that get you to understand why making a browser is a very complex task.

jonjacky 9mo ago

In addition to the code, the README here is exceptionally well done. It distinguishes this from many other learning projects.