Lumina(/peonies) server#

Notice: This project lives on Tangled, it is mirrored to Codeberg and a few other places, but the main development happens on Tangled. Please report issues and contribute on Tangled.

Lumina is a project in development, as the short description says "Just trying out an old concept.". It is not in any way ready for you to try. However, you are encouraged to contribute in any way!

Currently, as no stable is produced yet, code lives mainly in the development branch.

Developing info#

Developing#

Use flake.nix, either using direnv (there's an .envrc file to do this!) or with nix develop. This gets you all the dependencies, including Just. nix develop is still needed to also boot up a local database.

just dev # Prepares your enviroment and builds/runs the server with file watching.

Run just --list to see all possible recipes.

When running Lumina server in development mode, it automatically creates two accounts for you and one of those has an attached post on the global timeline.

Package relationships (outdated)#

---
config:
  layout: dagre
---
flowchart TB
 subgraph actors["🤹 Backend actors"]
        web{{"Webserver"}}
        iic{{"Interinstance communication"}}
        session[("Session Controller")]
        ssc(["Server Side Component"])
        storagecontroller{{"Storage controller"}}
  end
 subgraph Subgraph1["↙️ Server side"]
        backend["Lumina backend"]
        actors
  end
 subgraph Subgraph2["↗️ Client side"]
        spa(("SPA web client"))
  end
 subgraph Subgraph3["🌐 Interinstance"]
        instance[("External Lumina backend")]
  end
 subgraph Storage["💾 Storage"]
        pg["Postgres"]
        ets["ETS"]
  end
 subgraph Subgraph5["🧩 Packages"]
        package_backend["./lumina/backend"]
        package_components["./lumina/web/components"]
        package_spa["./lumina/web/initialiser"]
  end
    backend <--> web & iic & Storage
    web <--> session
    session <--> backend
    web -- serves --> spa
    spa -- loads --> ssc
    ssc <-- websocket --> session
    instance <--> iic
    ets <--> storagecontroller
    storagecontroller --> pg
    backend ==> package_backend
    ssc ==> package_components
    spa ==> package_spa

    pg@{ shape: disk}
    ets@{ shape: das}
    linkStyle 0 stroke:#00C853,fill:none
    linkStyle 1 stroke:#00C853,fill:none
    linkStyle 2 stroke:#00C853,fill:none
    linkStyle 3 stroke:#00C853,fill:none
    linkStyle 4 stroke:#00C853,fill:none
    linkStyle 5 stroke:#00C853,fill:none
    linkStyle 6 stroke:#00C853,fill:none
    linkStyle 8 stroke:#00C853,fill:none
    linkStyle 9 stroke:#00C853,fill:none
    linkStyle 10 stroke:#00C853
    linkStyle 11 stroke:#E1BEE7,fill:none
    linkStyle 12 stroke:#E1BEE7,fill:none
    linkStyle 13 stroke:#E1BEE7,fill:none