Vibeleaderboard
← Back to Tools
Index / tool

Assembly HTTP Server

github.com/dmtrkovalenko/assembly-http-server
Visit github.com
Category
Education
Rank
No. 2076Tools index

Previous survey · No. 2026 ·

Pricing
Open Source
Type
TOOL
Builder
dmtrkovalenko
GitHub
186 stars
Date

About

Under-200-LOC HTTP server written in pure assembly, plus an experimental React Server Components implementation. Educational for those curious about going to the metal.

What it does

Assembly HTTP Server exposes a small HTTP endpoint by opening a socket, accepting requests, matching request text, and writing fixed responses. A separate experiment serves React component payloads built from a local text file, with a browser client that fetches and renders them.

Why it's ranked here

Its value comes from making normally hidden server mechanics visible: socket setup, byte buffers, request matching, response headers, and connection handling all appear directly in assembly. The React experiment adds unusual depth, but the narrow platform support and intentionally primitive behavior keep it firmly educational.

What's good

The main server is compact enough to trace from startup through response delivery. It demonstrates address reuse, network byte order, routing, logging, and explicit socket closure. The companion experiment also shows component-stream headers, JSON escaping, formatted error payloads, and client-side rendering against an assembly backend.

Tradeoffs

It only targets Apple Silicon Macs and requires manual assembler and linker commands. Routing searches raw request text for two fixed paths, logging simply prints requests, and each accepted connection receives one response before closing. The component experiment depends on Node, legacy peer installation, a separate development server, and a hard-coded temporary input file.

How to use it well

Use it as a guided source-reading exercise for engineers learning how HTTP maps onto operating-system primitives. Change the port, routes, response bytes, or component payload handling, then observe the effects locally. It does not replace a production HTTP framework, portable server, or general React backend.

Technical notes+

server.s targets Darwin ARM64, invokes socket-related syscalls through svc #0x80, and calls libc for _printf, _htons, and _strstr. It binds port 6969, reads up to 1024 bytes per connection, matches GET /urmom and GET /urdad, writes static HTTP responses, and closes the client socket. react_server_components/server.s serves text/x-component, reads /tmp/rsc-content.txt into a 4096-byte buffer, escapes content into an 8192-byte buffer, translates paired asterisks into strong-element payload fragments, and emits a client-component error tree when opening the file fails. react_server_components/react-js-boring-stuff/src/framework/router.js fetches the component stream from localhost, while react_server_components/react-js-boring-stuff/scripts/build.js bundles the client with Webpack and the React Server Components plugin.

Observed

Primary language
ARM64 assembly, with JavaScript and CSS for the companion React experiment
Platform support
Apple Silicon macOS only
Install and build surface
Manual assembly and linking for the server; npm with legacy peer dependencies for the React client
Interface
HTTP server with fixed routes and a separate React Server Components endpoint
License
The bundled React demo package declares the MIT license
Repository structure
Contains a basic assembly server, a separate assembly component server, and a private npm-based React client

Read from README.md, react_server_components/react-js-boring-stuff/src/Layout.js, react_server_components/react-js-boring-stuff/scripts/build.js, react_server_components/react-js-boring-stuff/src/PepeAlert.js, react_server_components/react-js-boring-stuff/src/framework/router.js, react_server_components/react-js-boring-stuff/src/framework/bootstrap.js, server.s, react_server_components/server.s, react_server_components/example_output.txt, react_server_components/react-js-boring-stuff/README.md, react_server_components/react-js-boring-stuff/package.json, react_server_components/react-js-boring-stuff/.prettierignore, react_server_components/react-js-boring-stuff/public/style.css, react_server_components/react-js-boring-stuff/public/index.html.

What it can do

  • Serve HTTP requests

    HTTP requests from clients → HTTP responses

  • Handle web traffic

    Network connections on specified port → Web server responses

  • Render React Server Components

    React component definitions → Server-rendered HTML content

  • Demonstrate low-level web server implementation

    Assembly source code → Educational insight into HTTP server mechanics

  • Process HTTP protocol at assembly level

    Raw HTTP protocol data → Parsed and handled HTTP transactions

Tags

assemblyhttplow-leveleducationdmtr

Tech Stack

Assembly

Comments (0)

No comments yet

Editorially curated, with community endorsements as a secondary signal. Corrections welcome.