Astrologue-Website/developer/index.html

<!doctype html>
<html lang="en-nz">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Developer — Astrologue</title>
  <meta name="description" content="Astrologue builds its own foundations in Vala. The eleven libraries that power the operating system — collections, database, web stack, cryptography, intelligence, packaging — are free software, available to every developer.">
  <meta name="color-scheme" content="light dark">
  <meta name="theme-color" content="#f2ebda" media="(prefers-color-scheme: light)">
  <meta name="theme-color" content="#0a0a12" media="(prefers-color-scheme: dark)">
  <link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 64 64'%3E%3Ccircle cx='32' cy='32' r='27' fill='none' stroke='%23a8801f' stroke-width='4'/%3E%3Cpath d='M32 8l6 18 18 6-18 6-6 18-6-18-18-6 18-6z' fill='%23a8801f'/%3E%3Ccircle cx='32' cy='32' r='4' fill='%23003078'/%3E%3C/svg%3E">
  <meta property="og:title" content="Developer — Astrologue">
  <meta property="og:description" content="The libraries that raise Astrologue, offered to every developer: all Vala, meson-built, USM-packaged, free software.">
  <meta property="og:type" content="website">
  <link rel="stylesheet" href="../assets/css/style.css">
</head>
<body>
  <a class="skip-link" href="#main">Skip to content</a>

  <header class="masthead">
    <div class="container masthead__inner">
      <a class="brand" href="../">
        <img class="brand__logo brand__logo--light" src="../assets/img/astrologue-light.png" width="392" height="89" alt="Astrologue">
        <img class="brand__logo brand__logo--dark" src="../assets/img/astrologue-dark.png" width="392" height="89" alt="Astrologue">
      </a>
      <nav class="site-nav" aria-label="Primary">
        <ul class="site-nav__list">
          <li><a href="../">Home</a></li>
          <li><a href="../#news">News</a></li>
          <li><a href="../#download">Download</a></li>
          <li><a href="./" aria-current="page">Developer</a></li>
          <li><a class="nav-cta" href="../#download">Get Astrologue</a></li>
        </ul>
      </nav>
    </div>
  </header>

  <main id="main">

    <nav class="breadcrumb" aria-label="Breadcrumb">
      <div class="container">
        <ol>
          <li><a href="../">Astrologue</a></li>
          <li aria-current="page">Developer</li>
        </ol>
      </div>
    </nav>

    <section class="page-hero" id="top">
      <div class="container">
        <div class="hero__copy">
          <p class="kicker"><span>The developer's almanac</span></p>
          <h1 class="hero__title">
            Built in Vala, from the ground up.
            <span class="hero__accent">The libraries that raise Astrologue, offered to every developer.</span>
          </h1>
          <p class="lede">Astrologue builds its own foundations, and it builds them in Vala. The collections and the queries, the database layer, the web stack, the cryptography, the packaging — the eleven libraries that power the operating system are the same ones you can take into your own projects: free to run, study, share and improve.</p>
          <div class="hero__actions">
            <a class="btn btn--primary" href="#stack">Survey the Web-Stack</a>
            <a class="btn btn--ghost" href="#projects">Meet the eleven</a>
          </div>
          <p class="hero__note">Free software · LGPL-3.0-or-later for the libraries · built with meson, packaged with USM</p>
        </div>
      </div>
    </section>

    <section class="band band--plain" id="toolchain">
      <div class="container">
        <header class="section-head">
          <p class="kicker"><span>The working method</span></p>
          <h2>One language, one build, one package</h2>
          <p class="section-head__intro">Every project in the catalogue keeps the same discipline, so learning one teaches you the next.</p>
        </header>
        <div class="grid-pillars">
          <article class="pillar">
            <div class="pillar__body">
              <p class="pillar__num">I.</p>
              <h3>All Vala</h3>
              <p>Every library is written in Vala, from the Enumerable foundation to the HTTP server. Each compiles to C and the GObject ABI and ships its C header and Vala binding, and most add GIR introspection besides — open to other languages, not fenced in.</p>
            </div>
          </article>
          <article class="pillar">
            <div class="pillar__body">
              <p class="pillar__num">II.</p>
              <h3>Proven parts beneath</h3>
              <p>Where the ground is hard, the stack stands on battle-tested C: GLib, SQLite, libsodium, GnuTLS, GPGME, libssh, llama.cpp. The Vala libraries contribute the object model and the defaults — not fresh cryptography or a new database engine.</p>
            </div>
          </article>
          <article class="pillar">
            <div class="pillar__body">
              <p class="pillar__num">III.</p>
              <h3>One build, one package</h3>
              <p>Eleven projects, one shape: a <code>meson.build</code>, a <code>MANIFEST.usm</code> declaring what a project provides and needs down to individual files, and usm-scripts that build, test, install and package it the same way everywhere.</p>
            </div>
          </article>
        </div>
      </div>
    </section>

    <section class="band band--sky" id="stack">
      <div class="container">
        <header class="section-head">
          <p class="kicker"><span>The Web-Stack</span></p>
          <h2>How the pieces align</h2>
          <p class="section-head__intro">The request path of an Astrologue web application, as drawn in Spry's own README: each layer leans on the ones beneath it.</p>
        </header>

        <figure class="stack-map">
          <div class="stack-layer">
            <p class="stack-layer__name"><a href="astralis/">astralis</a></p>
            <p class="stack-layer__role">HTTP request handling</p>
            <div class="stack-layer stack-layer--child">
              <p class="stack-layer__name"><a href="statum/">Statum</a></p>
              <p class="stack-layer__role">pages, slots/state, directives, client JS</p>
              <div class="stack-layer stack-layer--child">
                <p class="stack-layer__name"><a href="spry/">Spry</a></p>
                <p class="stack-layer__role">users, auth slot, actions, guards</p>
                <div class="stack-branches">
                  <div class="stack-layer stack-layer--branch">
                    <p class="stack-layer__name"><a href="invercargill-sql/">Invercargill-Sql</a></p>
                    <p class="stack-layer__role">spry_users / spry_user_permissions schema</p>
                  </div>
                  <div class="stack-layer stack-layer--branch">
                    <p class="stack-layer__name"><a href="inversion/">Inversion</a></p>
                    <p class="stack-layer__role">module + service wiring</p>
                  </div>
                </div>
              </div>
            </div>
          </div>
          <figcaption>A request arrives at astralis, becomes a page and a state slot under Statum, and meets users and permissions through Spry — whose schema lives in Invercargill-Sql and whose wiring is done by Inversion.</figcaption>
        </figure>

        <h3 class="firmament-title">Around the stack</h3>
        <div class="firmament">
          <div class="firmament__item">
            <p class="firmament__name"><a href="invercargill/">Invercargill</a></p>
            <p>the collections and queries underneath every layer above</p>
          </div>
          <div class="firmament__item">
            <p class="firmament__name"><a href="locksmith/">Locksmith</a></p>
            <p>objects-not-byte-arrays cryptography, wire-compatible with the stack's signed slots</p>
          </div>
          <div class="firmament__item">
            <p class="firmament__name"><a href="vallama/">Vallama</a></p>
            <p>local LLM inference for the applications you build on it</p>
          </div>
          <div class="firmament__item">
            <p class="firmament__name"><a href="usm/">USM</a></p>
            <p>the source packaging that carries the stack — and your own projects too</p>
          </div>
        </div>
      </div>
    </section>

    <section class="band band--plain" id="projects">
      <div class="container">
        <header class="section-head">
          <p class="kicker"><span>The catalogue</span></p>
          <h2>Eleven libraries</h2>
          <p class="section-head__intro">Grouped by trade. Each card opens onto its documentation: what the library does, how to build and install it, and worked examples from its own source.</p>
        </header>

        <div class="group-head">
          <p class="group-head__num">I.</p>
          <h3>Foundations</h3>
          <p class="group-head__note">the ground the rest is built on</p>
        </div>
        <div class="grid-projects">
          <article class="project-card">
            <div class="project-card__top">
              <h3><a href="invercargill/">Invercargill</a></h3>
              <span class="project-card__tag">Foundation</span>
            </div>
            <p class="project-card__summary">The Enumerable library for Vala — LINQ-style querying plus the Vector, Dictionary, Series and buffer data structures the whole stack is written against.</p>
            <p class="project-card__meta">
              <span>LGPL-3.0-or-later</span>
              <a class="project-card__more" href="invercargill/">Documentation&nbsp;→</a>
            </p>
          </article>
          <article class="project-card">
            <div class="project-card__top">
              <h3><a href="invercargill-json/">Invercargill-Json</a></h3>
              <span class="project-card__tag">Foundation</span>
            </div>
            <p class="project-card__summary">JSON support for Invercargill: documents become Enumerable collections that query and transform like any other sequence.</p>
            <p class="project-card__meta">
              <span>LGPL-3.0-or-later</span>
              <a class="project-card__more" href="invercargill-json/">Documentation&nbsp;→</a>
            </p>
          </article>
          <article class="project-card">
            <div class="project-card__top">
              <h3><a href="inversion/">Inversion</a></h3>
              <span class="project-card__tag">Foundation</span>
            </div>
            <p class="project-card__summary">Inversion of control for the Web-Stack: a dependency-injection container with modules, scopes and three lifecycles, wired by field injection.</p>
            <p class="project-card__meta">
              <span>LGPL-3.0-or-later</span>
              <a class="project-card__more" href="inversion/">Documentation&nbsp;→</a>
            </p>
          </article>
        </div>

        <div class="group-head">
          <p class="group-head__num">II.</p>
          <h3>Data</h3>
          <p class="group-head__note">rows, schemas and migrations</p>
        </div>
        <div class="grid-projects">
          <article class="project-card">
            <div class="project-card__top">
              <h3><a href="invercargill-sql/">Invercargill-Sql</a></h3>
              <span class="project-card__tag">Data</span>
            </div>
            <p class="project-card__summary">A generic SQL abstraction built on Invercargill data structures — query results return as lazy Enumerable rows over a provider-neutral API, with SQLite beneath today.</p>
            <p class="project-card__meta">
              <span>LGPL-3.0-or-later</span>
              <a class="project-card__more" href="invercargill-sql/">Documentation&nbsp;→</a>
            </p>
          </article>
          <article class="project-card">
            <div class="project-card__top">
              <h3><a href="invercargill-sql-inversion/">Invercargill-Sql-Inversion</a></h3>
              <span class="project-card__tag">Data</span>
            </div>
            <p class="project-card__summary">The Inversion integrations for Invercargill-Sql: DatabaseConfigurator, MigrationStartupService and InversionTypeProvider wire the database into the container.</p>
            <p class="project-card__meta">
              <span>LGPL-3.0-or-later</span>
              <a class="project-card__more" href="invercargill-sql-inversion/">Documentation&nbsp;→</a>
            </p>
          </article>
        </div>

        <div class="group-head">
          <p class="group-head__num">III.</p>
          <h3>Web stack</h3>
          <p class="group-head__note">from socket to signed state</p>
        </div>
        <div class="grid-projects">
          <article class="project-card">
            <div class="project-card__top">
              <h3><a href="astralis/">Astralis</a></h3>
              <span class="project-card__tag">Web stack</span>
            </div>
            <p class="project-card__summary">The library for writing HTTP backends in Vala: routing, headers, cookies, form data, JSON APIs, server-sent events, and layered web-config.json settings.</p>
            <p class="project-card__meta">
              <span>LGPL-3.0-or-later</span>
              <a class="project-card__more" href="astralis/">Documentation&nbsp;→</a>
            </p>
          </article>
          <article class="project-card">
            <div class="project-card__top">
              <h3><a href="statum/">Statum</a></h3>
              <span class="project-card__tag">Web stack</span>
            </div>
            <p class="project-card__summary">Page rendering and state management for web applications: server-rendered pages, signed and encrypted state slots, directives and actions, bound by a small client script.</p>
            <p class="project-card__meta">
              <span>LGPL-3.0-or-later</span>
              <a class="project-card__more" href="statum/">Documentation&nbsp;→</a>
            </p>
          </article>
          <article class="project-card">
            <div class="project-card__top">
              <h3><a href="spry/">Spry</a></h3>
              <span class="project-card__tag">Web stack</span>
            </div>
            <p class="project-card__summary">Reusable authentication and user-management services for Statum — the signed auth slot, guards and subclassable actions — plus the spry CLI that scaffolds, keys and deploys an application.</p>
            <p class="project-card__meta">
              <span>LGPL-3.0-or-later</span>
              <a class="project-card__more" href="spry/">Documentation&nbsp;→</a>
            </p>
          </article>
        </div>

        <div class="group-head">
          <p class="group-head__num">IV.</p>
          <h3>Security</h3>
          <p class="group-head__note">keys, seals and signatures</p>
        </div>
        <div class="grid-projects">
          <article class="project-card">
            <div class="project-card__top">
              <h3><a href="locksmith/">Locksmith</a></h3>
              <span class="project-card__tag">Security</span>
            </div>
            <p class="project-card__summary">Developer-friendly cryptography in objects, not byte arrays: sodium boxes, X.509, SSH, OpenPGP and WebPush over libsodium, GnuTLS, GPGME and libssh. It implements no cryptography itself.</p>
            <p class="project-card__meta">
              <span>LGPL-3.0-or-later</span>
              <a class="project-card__more" href="locksmith/">Documentation&nbsp;→</a>
            </p>
          </article>
        </div>

        <div class="group-head">
          <p class="group-head__num">V.</p>
          <h3>Intelligence</h3>
          <p class="group-head__note">language models, locally</p>
        </div>
        <div class="grid-projects">
          <article class="project-card">
            <div class="project-card__top">
              <h3><a href="vallama/">Vallama</a></h3>
              <span class="project-card__tag">Intelligence</span>
            </div>
            <p class="project-card__summary">High-level Vala bindings for llama.cpp inference: chat sessions, grammar-constrained tool calling, embeddings and tokenizers — running on your own hardware.</p>
            <p class="project-card__meta">
              <span>LGPL-3.0-or-later</span>
              <a class="project-card__more" href="vallama/">Documentation&nbsp;→</a>
            </p>
          </article>
        </div>

        <div class="group-head">
          <p class="group-head__num">VI.</p>
          <h3>Packaging</h3>
          <p class="group-head__note">how it all ships</p>
        </div>
        <div class="grid-projects">
          <article class="project-card">
            <div class="project-card__top">
              <h3><a href="usm/">USM</a></h3>
              <span class="project-card__tag">Packaging</span>
            </div>
            <p class="project-card__summary">The Universal Source Manifest: a project declares what it provides and needs in a MANIFEST.usm, and usm acquires, builds, tests, packages and deploys it.</p>
            <p class="project-card__meta">
              <span>GPL-3.0-or-later</span>
              <a class="project-card__more" href="usm/">Documentation&nbsp;→</a>
            </p>
          </article>
        </div>
      </div>
    </section>

  </main>

  <footer class="site-footer">
    <div class="container">
      <div class="footer-grid">
        <div class="foot-brand">
          <img class="brand__logo brand__logo--dark" src="../assets/img/astrologue-dark.png" width="392" height="89" alt="Astrologue">
          <p>An operating system for change — kept for self sufficiency, resilience, and software freedom, so regular people can hold the power of general purpose computers in their own hands.</p>
        </div>
        <nav aria-label="The four freedoms">
          <p class="foot-title">The Four Freedoms</p>
          <ol class="freedoms">
            <li><strong>Run</strong> the software as you wish, for any purpose.</li>
            <li><strong>Study</strong> the source and change it to do your computing as you wish.</li>
            <li><strong>Share</strong> copies so you can help others.</li>
            <li><strong>Modify</strong> and publish your versions so everyone benefits.</li>
          </ol>
        </nav>
        <nav aria-label="Site">
          <p class="foot-title">Site</p>
          <ul class="foot-list">
            <li><a href="../">Home</a></li>
            <li><a href="../#news">News</a></li>
            <li><a href="../#download">Download</a></li>
            <li><a href="./">Developer</a></li>
          </ul>
        </nav>
      </div>
      <p class="colophon">Set in Cinzel and EB Garamond (SIL Open Font License). Astrologue is free software, licensed GPL-3.0-or-later: take it, tend it, pass it on. The libraries are LGPL-3.0-or-later, so they remain free to link.</p>
    </div>
  </footer>
</body>
</html>