Remix.run Logo
My website is one binary (2022)(j3s.sh)
53 points by smartmic 2 days ago | 47 comments
liampulles a day ago | parent | next [-]

I wrote a Go program to generate my blog (which is just a static site hosted on Github pages). I made it so that I could write blog posts with a "widget builder" DSL, which is a good compromise for me between customizabiity for individual pages vs being able to write 95% of everything with markdown.

Example of DSL: https://github.com/liampulles/liampulles.github.io/blob/mast...

Blog post with more info, and my site: https://liampulles.com/moving-blog.html

lelanthran a day ago | parent | next [-]

My blog[1] is also generated from nothing but markdown, but I leaned on pandoc heavily for this: https://gist.github.com/lelanthran/2634fc2508c93a437ba5ca511...

---------------------

[1] www.lelanthran.com

liampulles 12 hours ago | parent [-]

Interesting approach, I like it!

cookiengineer a day ago | parent | prev | next [-]

Just FYI:

The meta viewport tag disallows zooming/using your website. I had to switch to Desktop mode on my Android phone to be able to read half the content that was overflowing and not visible.

liampulles 12 hours ago | parent [-]

Thanks for the feedback, I will look into this.

yboris a day ago | parent | prev [-]

Awesome! I'm curious if you considered Hugo and if yes, why you preferred to build your own Go website generator :)

liampulles 12 hours ago | parent [-]

I considered Hugo, but I wanted to do my own thing mainly because I'm very fussy about the raw HTML in my site, i.e. I want to use semantic HTML5 tags as much as possible. I haven't used Hugo though so I could not say how good or bad it is.

paranoidxprod a day ago | parent | prev | next [-]

From one of these user's most recent posts here https://j3s.sh/thought/blogs-rot-wikis-wait.html:

  p.s. i'm working on a new wiki to replace my website with - something new, from the ground up.

  git.j3s.sh/abyss - stay tuned

I wonder if they'll still be using a similar approach for the new site.
j3s a day ago | parent [-]

it's still in the works, but here's the plan:

- written in golang, one binary

- custom markup lang

- very short urls (https://j3s.sh/$pagename)

- pages are saved as text-files-written-to-disk with git autocommits (similar to mycorrhiza[0])

- "blocks" that process parts of pages differently - similar to edna[1]

- pages editable via web interface (rudimentary phone support)

- autolinks between pages

- simple picture upload interface (^V with a pic in clipboard will upload the pic + paste appropriate markup)

- single user system, intended as a personal knowledge base

this system will replace https://j3s.sh and https://abyss.j3s.sh eventually -- all old links will redirect to the new wiki. it's been quite an undertaking, but i think the end result will be worth it :3

[0]: https://github.com/bouncepaw/mycorrhiza

[1]: https://edna.arslexis.io

lelanthran a day ago | parent [-]

See my comment upthread; I'm very curious why PHP would not have worked for you.

j3s a day ago | parent [-]

because i don't enjoy working with PHP

lelanthran a day ago | parent | prev | next [-]

I'm not seeing the point here, TBH. What use-case does this author's single-binary satisfy?

1. You just want to serve static files from your blog? Install a webserver and knock yourself out in your editor, creating html and css (and maybe js) files.

2. You want to serve static files, with some dynamic crap stuffed inside here and there like the examples given in the article? Install the mod_php or equivalent for your webserver, and go mad with the editor.

3. You want fully generated content? Install one of the many backend frameworks in any language you want to use, and then go mad in your IDE.

What use-case does "one binary I wrote in Go" satisfy that isn't covered above? From everything I gleaned from the article, the PHP solution is even easier, while still technically being "one single binary".

EDIT: as an example of over-engineering, here is the authors code for a specific use-case:

    func ipHandler(w http.ResponseWriter, r *http.Request) {
     w.Header().Set("Content-Type", "text/plain")
     fmt.Fprintf(w, r.Header.Get("X-Forwarded-For")+"\n")
    }
    ...
    http.HandleFunc("/ip", ipHandler)
And here is the equivalent in PHP:

    header('Content-Type: text/plain');
    echo $_SERVER['REMOTE_ADDR'];
bob1029 a day ago | parent | next [-]

> What use-case does "one binary I wrote in Go" satisfy that isn't covered above?

In .NET land, one of the top reasons to go all-in with a single exe web server would be performance. Kestrel can be unbelievably fast if you remove all of the layers of indirection like IPC and hosted SQL. I've got dynamic HTML pages that render in <100uS and that includes managing session state and other queries into SQLite.

Concerns like accidentally showing up on the front page of HN or even petty DDOS attempts can be often be ignored when you are able to serve content this quickly.

The other major reason I like it is having everything in one type system and debugger experience. I can set a breakpoint anywhere and inspect everything.

0x6c6f6c 2 hours ago | parent | prev | next [-]

The author also says they want to be able to understand all of the components of the system. Software that needs upgrades that may not be backwards compatible is an issue. I imagine many web servers can fall under either of these concerns, including Apache and Nginx.

I'm not a fan of Go myself, but I can see how a simple Go HTTP server fits the bill.

malwrar a day ago | parent | prev | next [-]

Easier to deploy? No need for packaging everything or installing runtime stuff, just copy one file on your server and run it.

dlachausse a day ago | parent | next [-]

I think a lot of younger developers don't realize that there was a time where you simply FTPed your files up to a directory on a web server. If you wanted to live dangerously, you could even edit them live on the server through a shell account.

indigodaddy a day ago | parent | prev [-]

Redbean is another good candidate for accomplishing this.

jbreckmckye a day ago | parent | prev | next [-]

But Go is so simple!

(Points to a myriad of Go functions that do in eight or nine lines what other languages do in two)

acuozzo a day ago | parent [-]

I'm not defending Go here, but simplicity can also be used to describe not having to incur the cost of (often leaky) abstractions when things go wrong under the hood or when you need to do something different from the intended use-case(s).

For instance, PyTorch is simple until you have a __need__ (e.g., rfft/irfft with bfloat16) to drop to CUDA and, in so doing, break autograd and all kinds of other things. Now you need to write a Torch extension and handle Meta/Fake tensors and the like if you want it to work with torch.compile. A lot of the simplicity goes right out the window.

If you run into this a lot, then you're doing something sufficiently weird for the simpler solution to, well, not be simpler.

Veen a day ago | parent | prev | next [-]

It solves the author's use case, which the article explains at some length.

dlachausse a day ago | parent | prev | next [-]

I think a lot of it is just for the author's own fun, enjoyment, and amusement. Also, golang is probably their favorite hammer. It's not efficient for me to smoke a brisket myself or make furniture by woodworking, but I enjoy it. Not everything has to have any more purpose than that.

j3s a day ago | parent [-]

bingo. i'm not trying to claim that everyone should do this in go -- it's just a language that i like to use. by all means, use ruby, or PHP, or Elixir, or whatever else you like!

hkon a day ago | parent | prev [-]

sigh

sha16 a day ago | parent | prev | next [-]

I was using Python's Pelican static site generator for some time until I wanted to further customize the template fragments of a theme. Started running into issues and even helped fix a bug with the build command. Eventually I couldn't be bothered and wrote my own static site, except with Nextjs instead of plain HTML. Didn't take long and I don't have to mess around with awkward jinja templates anymore.

vunderba a day ago | parent [-]

Similarly I started out with Pelican but eventually needed more fine control over the site using MDX/etc. so I migrated my site over to Astro and have been pretty happy with it.

exiguus a day ago | parent | prev | next [-]

I like the idea, but I don't like that the result is not accessible. For example, there are no headlines, lists, or paragraphs—just a huge pre, or if you remove the 'thoughtbody' class from the p element, you can see how well a screen reader can read it.

I also have extensive experience with static sites, starting from using just Apache Directory Listing (Footer, Header, SSI), to writing my own in Perl, Ruby on Rails, Go, and TypeScript, using frameworks like Astro, Next, or Zola. Apart from the Apache setup and some Perl scripts, all of them had one thing in common: I used Markdown because it is easy to transform into HTML, which means it is accessible.

j3s a day ago | parent [-]

agreed, accessibility is something i'm hoping to fix with my wiki rewrite! that and phone formatting x_x

exiguus a day ago | parent [-]

I really like the (let's call it) ‘ASCII look’. I would be delighted if you could share an update with the mobile-ready/accessible version.

dang a day ago | parent | prev | next [-]

Related:

My website is one binary - https://news.ycombinator.com/item?id=44345752 - June 2025 (1 comment)

My website is one binary (2022) - https://news.ycombinator.com/item?id=37964917 - Oct 2023 (168 comments)

My website is one binary - https://news.ycombinator.com/item?id=30937515 - April 2022 (67 comments)

Twey a day ago | parent | prev | next [-]

Rather than a compiled blob generated from a language propped up by Google (a company famed for killing beloved projects) that is compiled and therefore unmodifiable and unrecoverable if the source or toolchain is lost, it feels like these goals would have been better served by writing it as some POSIX-compatible sh scripts, or even a (pre-packaged/no-build) JavaScript bundle — we've been trying to kill that thing for decades, and it's still kicking!

usixk a day ago | parent | prev | next [-]

Pleasantly surprised how jovial this post was. Thanks!

a day ago | parent | prev | next [-]
[deleted]
indigodaddy a day ago | parent | prev | next [-]

This is actually a great post. Love the idea of single binary and low dependencies to keep things as lean as possible.

xandrius a day ago | parent | prev | next [-]

Anytime I see someone writing without any capital letters, I stop and close the page. I understood that they care more about themselves (the writer) than the reader, so I let them write without my reading, as they signaled they don't care about it. Respectable.

quesera a day ago | parent | next [-]

How do you feel about people who speak with accents?

lelanthran a day ago | parent [-]

> How do you feel about people who speak with accents?

You think people with accents do it on purpose?

How do you feel about people who talk to you in a fake accent for no reason whatsoever?

This looks like the same thing.

quesera a day ago | parent [-]

Looks like it, but it often is not.

Affectation is one thing, but the behaviour you describe is as much cultural and contextual as it is affectation. Just like an accent.

Very very much not worth thinking about too hard, except for its anthropological implications. IMO, of course.

imperialdrive a day ago | parent | prev | next [-]

it is likely an informal, stylistic choice, nbd honestly

fragmede a day ago | parent | prev [-]

good to know. so now you've closed this page now and gotten back to work? i wonder where else you read things on the internet

simpaticoder a day ago | parent | prev | next [-]

I believe that similar concerns/aesthetics drove the development of https://redbean.dev/

Quitschquat a day ago | parent | prev | next [-]

I do this with CLOG, save-lisp-and-die

daitangio a day ago | parent | prev | next [-]

Yes hugo+template+isso (my Giorgi.com setup) has some hidden dependencies but you can get a fancy site in very little time. A dynamic web site is exciting to design, but require a lot of effort… I suggest to use Python Django: it has a tutorial for a blog!

throwmeaway222 a day ago | parent | prev | next [-]

So I guess one docker image is also one binary...

OptionOfT a day ago | parent | next [-]

A Docker container can launch a single process or multiple processes [0] (please don't do this, use docker as the separation & health checker).

In the former case we have a single executable. We can now choose to statically compile all dependencies with musl.

We can also statically compile all the assets (HTML, images) into the binary.

Then you take your Docker image and build a FROM scratch image, copy in your binary and you've got a super-lightweight container.

[0] https://www.bugsink.com/blog/multi-process-docker-images/

j3s a day ago | parent | prev [-]

i have some thoughts about this >:) https://abyss.j3s.sh/hypha/docker

minroot a day ago | parent | prev | next [-]

It's true, static sites are low energy.

ribcage a day ago | parent | prev [-]

[dead]