No description
  • Python 59.3%
  • Shell 16.6%
  • CSS 15.7%
  • HTML 7.9%
  • Dockerfile 0.5%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
drorganvidez f7e609a5b9
All checks were successful
SPLENT validate / lint (push) Successful in 50s
SPLENT validate / validate (push) Successful in 1m22s
SPLENT validate / test (push) Successful in 11m51s
SPLENT validate / alert (push) Successful in 4s
chore: runtime framework 1.35.0 and CLI 1.67.0
2026-11-19 13:23:36 +01:00
.forgejo/workflows CI: the test job installs uv, so features install with the overrides (splent_cli 1.66) 2026-11-19 11:32:39 +01:00
deploy chore: release splent_marketplace_app to v0.4.1 2026-11-13 18:24:15 +00:00
docker chore: release splent_marketplace_app to v0.4.1 2026-11-13 18:24:15 +00:00
entrypoints Upgrade to framework 1.32, CLI 1.61 and the latest features 2026-11-08 16:27:00 +01:00
scripts Upgrade to framework 1.32, CLI 1.61 and the latest features 2026-11-08 16:27:00 +01:00
src Format the app factory 2026-10-10 18:40:13 +02:00
.gitignore The image's runtime pins live in pyproject.toml 2026-10-11 02:28:52 +02:00
LICENSE feat: product scaffold — marketplace_spl derivation (theme, auth, settings, marketplace, configurator) 2026-07-26 17:36:06 +02:00
package-lock.json feat: product scaffold — marketplace_spl derivation (theme, auth, settings, marketplace, configurator) 2026-07-26 17:36:06 +02:00
package.json feat: product scaffold — marketplace_spl derivation (theme, auth, settings, marketplace, configurator) 2026-07-26 17:36:06 +02:00
pyproject.toml chore: runtime framework 1.35.0 and CLI 1.67.0 2026-11-19 13:23:36 +01:00
README.md Deploy from a clone with docker compose alone 2026-10-11 00:30:11 +02:00
splent.contracts.json Pin spl_registry 0.8.0 (no ceiling on product lines per developer) 2026-11-13 19:15:57 +01:00

splent_marketplace_app

A web application built with SPLENT, derived from the marketplace_spl product line.

This repository is a thin shell. It declares which features the product installs (see pyproject.toml) and SPLENT composes, validates and runs them.

Run it locally

Your machine only needs Docker, Git and GNU Make. Python, Node and the database all live inside containers, so nothing else has to be installed.

1. Create a workspace

A SPLENT product is not standalone. It lives in a workspace folder next to the SPLENT tooling repositories.

mkdir splent_workspace && cd splent_workspace
git clone https://git.splent.io/splent-io/splent_framework.git
git clone https://git.splent.io/splent-io/splent_cli.git
git clone https://git.splent.io/splent-io/splent_marketplace_app.git

Those three are all you need to run the product. The variability model this product derives from is not one of them: pyproject.toml records its DOI under [tool.splent.spl_model], so the CLI downloads it once from UVLHub and caches it under .splent_cache/spls/.

2. Check your Git config file

The CLI container mounts your ~/.gitconfig. If that file does not exist, Docker creates it as an empty directory and installing features fails later. Create it once as a real file.

rm -rf ~/.gitconfig && touch ~/.gitconfig
git config --global user.name "Your Name"
git config --global user.email "you@example.com"

3. Start the SPLENT CLI

cd splent_cli
make setup

That prepares the workspace .env, starts the CLI container and drops you inside it. Every splent command below runs in there. From the host you can also use docker exec splent_cli_container splent <command>.

4. Bring the product up

splent product:select splent_marketplace_app
splent product:resolve        # install the features declared in pyproject.toml
splent product:derive --dev   # build images, run migrations, start the stack
splent db:seed -y             # load demo data, optional

The first derive downloads images and compiles assets, so give it a few minutes. When it finishes the app is served at http://localhost:5818, and splent product:port prints that URL again whenever you need it.

Run it on a server

A server needs Docker with the Compose plugin and a clone of this repository. It needs no workspace and no SPLENT CLI. Everything it runs is in deploy/, which splent product:build writes and this repository versions.

git clone https://git.splent.io/splent-io/splent_marketplace_app.git
cd splent_marketplace_app/deploy
cp .env.example .env      # fill in the required values
docker compose up -d

docker compose up refuses to start until every required value in .env is set, and names the one that is missing. deploy/README.md lists them, and says how to upgrade.

Everyday commands

Command What it does
splent product:up --dev Start the stack
splent product:down --dev Stop the stack
splent product:restart Restart the Flask app
splent product:logs Tail the container logs
splent product:console Python shell with the app loaded
splent feature:status Features installed in this product
splent db:migrate Generate and apply a migration
splent product:port Print the local URL

When something looks wrong

splent product:logs       # what the app actually says
splent doctor             # full workspace diagnosis

splent product:validate goes further and checks that the feature selection satisfies the variability model, downloading the model first if this machine has never seen it.

Documentation

Everything else, from the feature catalog and the UVL variability model to the full command reference and deployment, lives at docs.splent.io.