No description
  • Python 92.9%
  • CSS 3%
  • Shell 2.6%
  • HTML 1.2%
  • Dockerfile 0.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
drorganvidez 4f9f689b03
All checks were successful
SPLENT validate / lint (push) Successful in 1m17s
SPLENT validate / validate (push) Successful in 1m44s
SPLENT validate / test (push) Successful in 9m44s
SPLENT validate / alert (push) Successful in 2s
chore: release innosoft_app to v0.1.2
2026-11-19 16:39:16 +00:00
.forgejo/workflows features: redis 1.7.1, nginx 1.7.1 and autodeploy 0.5.1, which run their images by digest 2026-11-19 17:20:02 +01:00
deploy chore: release innosoft_app to v0.1.2 2026-11-19 16:39:16 +00:00
docker chore: release innosoft_app to v0.1.2 2026-11-19 16:39:16 +00:00
entrypoints Deploy from the deploy/ bundle with autodeploy 2026-10-11 18:26:40 +02:00
migration Stop folding informative pages into edition descriptions; add a cleanup pass 2026-08-17 01:28:01 +02:00
scripts Deploy from the deploy/ bundle with autodeploy 2026-10-11 18:26:40 +02:00
src templates: no web fonts from Google 2026-10-31 22:07:24 +01:00
.gitignore Recover all InnoSoft Days editions and turn each into a hub 2026-08-17 00:24:47 +02:00
LICENSE feat: InnoSoft Days — event website built with the CMS SPL 2026-06-28 01:59:03 +02:00
package-lock.json feat: InnoSoft Days — event website built with the CMS SPL 2026-06-28 01:59:03 +02:00
package.json feat: InnoSoft Days — event website built with the CMS SPL 2026-06-28 01:59:03 +02:00
pyproject.toml chore: release innosoft_app to v0.1.2 2026-11-19 16:39:16 +00:00
README.md README: the model comes from UVLHub by DOI, not from splent_catalog 2026-10-06 23:00:11 +02:00
splent.contracts.json features: redis 1.7.1, nginx 1.7.1 and autodeploy 0.5.1, which run their images by digest 2026-11-19 17:20:02 +01:00

innosoft_app

A web application built with SPLENT, derived from the cms_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://github.com/diverso-lab/splent_framework.git
git clone https://github.com/diverso-lab/splent_cli.git
git clone https://github.com/splent-io/innosoft_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 innosoft_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:5800, and splent product:port prints that URL again whenever you need it.

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.