flip-jump — the upstream language repo

github.com/tomhea/flip-jump

🐙 Open the repository

The canonical home of the FlipJump language: the assembler, the interpreter, the standard library that this site auto-documents, example programs, the test suite, and the GitHub wiki.

What lives there

Directory

Contents

flipjump/assembler/

The fj assembler — turns .fj source into .fjm binaries

flipjump/interpreter/

The runtime that executes .fjm binaries

flipjump/stl/

The standard library — source for every macro on this site

programs/

Real example programs: hello world, prime sieve, calculator, quine

tests/

The test suite that proves a release works

What to do there

  • Read the standard-library source — every macro page on this site links back to its .fj source. Reading two or three short macros side-by-side with their rendered docs is the fastest way to internalise the patterns.

  • File issues — bugs in the language, missing macros, doc gaps. Issues here also drive what eventually shows up in this docs site.

  • Send PRs — adding a macro to the STL, fixing an interpreter bug, improving the test suite. Doc PRs for THIS site go to tomhea/flipjump-docs instead.

  • Browse the wiki — the GitHub wiki has the original “Learn FlipJump” tutorial that bootstrapped most of this site’s language reference.

Releases

Latest tagged release is visible at github.com/tomhea/flip-jump/releases. This docs site pins a specific upstream commit via a git submodule; a weekly automated job bumps the pin and surfaces upstream STL changes as a PR for review.

See also