Skip to content

Deployment

Local execution is verified. GitHub Actions workflows are prepared for the public repository at https://github.com/vxx2207/ingoshift.

Local demo

git clone https://github.com/vxx2207/ingoshift.git
cd ingoshift
python -m venv .venv
.venv/bin/python -m pip install -e ".[dev]"
.venv/bin/ingoshift run-all --workdir data/demo
.venv/bin/ingoshift dashboard --workdir data/demo \
  --out reports/dashboard.html

On Windows, replace .venv/bin/ with .venv\Scripts\.

Verify with:

.venv/bin/pytest
.venv/bin/ingoshift status --workdir data/demo
.venv/bin/mkdocs build --strict

Live TED radar

.venv/bin/ingoshift run-all --live --source ted \
  --workdir data/live-ted
.venv/bin/ingoshift dashboard --workdir data/live-ted \
  --out reports/live-ted-dashboard.html

The source is anonymous and needs no API secret. The response is stored in the immutable raw layer before parsing and validation.

GitHub repository and Pages

  1. From this project directory, run:

bash git add . git commit -m "Ship IngoShift live TED radar and portfolio dashboard" git remote add origin https://github.com/vxx2207/ingoshift.git git push -u origin main

  1. In GitHub, open Settings → Pages and set Source to GitHub Actions.
  2. Open the Actions tab. Confirm both CI and Pages are green.
  3. Open the deployment URL printed by the Pages workflow and verify the dashboard link, filters, and mobile layout.

.github/workflows/pages.yml regenerates the labelled demo, builds MkDocs strictly, uploads the static site, and deploys it. .github/workflows/ci.yml runs linting, strict typing, docs, and the Python/OS test matrix.

Full profile

The Docker/PostgreSQL profile is design work, not a verified deployment. The current application uses SQLite. The API server is also not implemented, so make serve exits with an honest explanation.

No secret is required for the demo or live TED run. .env is reserved for future services and must never be committed.