porffor Documentation

Technical Documentation: CanadaHonk/porffor

ℹ️ Provenance: Multi-Tier Ingestion · CodeWiki Reference

Overview (`README.md`) Copy Section

Porffor  ^{_*(poor-for)*}

An ahead-of-time JavaScript compiler

curl -fsSL https://porffor.dev/install.sh | sh

$ cat hello.js
console.log('hello world!');
$ porf hello.js -o hello
[105ms] compiled hello.js -> hello (33.7KB)
$ ./hello
hello world!

Porffor is a 100% AOT compiled JS engine/runtime. There is nothing interpreted or compiled just-in-time. Porffor compiles JS to C (with an IR inbetween). We chose this approach because:

• it can be used essentially everywhere
• is relatively easy to emit and compile
• it avoids directly depending on a backend like LLVM or Cranelift
• is easily modifiable post-compile for diverse environments

Versioning Copy Chapter

Porffor releases use a single increasing release number. Releases are automatically published every git push after CI testing.

Name Copy Chapter

purple in Welsh is porffor. Why purple?

• No other JS engine is purple colored
• Purple is pretty cool
• Purple apparently represents "ambition", which accurately describes this project :)

--- METRICS ---

• Files Extracted: 1
• Estimated Token Budget: ~269 tokens
• Canonical Reference: https://codewiki.google/github.com/CanadaHonk/porffor