Getting Started

Install Foundation Base and choose one focused workflow.

The repository spans many libraries and runtimes. Start with Java, Leiningen, and one target area; optional tools can be added later.

Full setup guideContributor guide

1    Install

git clone [email protected]:zcaudate-xyz/foundation-base.git\ncd foundation-base\nlein deps\nlein install\nlein repl

2    Choose a first task

std

Use a Clojure library

Start with std.lib and a focused guide.

Learn more
hara

Generate target code

Emit a JavaScript or Lua form, then follow the language walkthroughs.

Learn more
code.test

Run one test namespace

Use a targeted run rather than configuring every optional runtime.

Learn more
examples

Inspect generated projects

Compare authored Clojure source with generated repositories.

Learn more

2.1    Targeted tests

lein test :only std.lib.collection-test\nlein test :with std.lib

3    Related libraries

The foundation volumes referenced above, each with the closest external alternative for comparison.

std.libfoundation

standard utility library — collections, strings, fs, concurrency, testing primitives

closest external overlap: medley plus clojure.java.io and core.async basics, packaged together with no external dependencies

harafoundation

multi-language code generation and runtime emission for JavaScript, Lua, Python, R and SQL targets

closest external overlap: template-based code generators; hara emits from live Clojure forms instead of templates

code.testfoundation

fact-based test framework where every check links back to a source var

closest external overlap: clojure.test and Midje; facts here double as documentation examples for code.doc

code.managefoundation

namespace and test management — incomplete, orphaned, commented and pedantic audits over the project

closest external overlap: lint tooling such as Eastwood or clj-kondo, driven by static project analysis

code.docfoundation

documentation generator producing the sites you are reading

closest external overlap: codox and cljdoc, with executable examples, themes and multi-site publishing

xtfoundation

cross-language spec and runtime layer with seed-generated parity tests per target

closest external overlap: Haxe or a transpiled standard library — one API surface, many target languages

External projects that overlap with foundation volumes.

medleyexternal

small, pure functions for map and collection manipulation

overlaps with std.lib.collection; std.lib bundles a wider set of everyday utilities

cljdoc / codoxexternal

hosted API documentation for Clojure libraries, generated from source

foundation publishes themed multi-volume sites via code.doc; codox output is also generated for API reference

Haxeexternal

cross-platform language and toolkit targeting many runtimes

similar 'write once, target many' goal as xt/hara, via a dedicated language rather than Clojure forms

4    Links

GitHubFull setup guideExamplesContributingIssue trackerAPI reference (codox)