Skip to content

Add GUI welcome screen, logo branding, and one-command launcher#5

Merged
omoultosEthTuDelft merged 1 commit into
mainfrom
gui-welcome-launcher
Jun 10, 2026
Merged

Add GUI welcome screen, logo branding, and one-command launcher#5
omoultosEthTuDelft merged 1 commit into
mainfrom
gui-welcome-launcher

Conversation

@omoultosEthTuDelft

Copy link
Copy Markdown
Collaborator

Summary

  • Replace the "OpenPyTEA" wordmark in the GUI header with a logo image (frontend/public/logo.png)
  • Add a welcome/splash page shown on first load — logo, short description, feature list, and a Get Started button
  • New start.sh one-command launcher at the repo root: bootstraps .venv + frontend deps on first run, starts backend (:8000) and frontend (:5173) together, opens the browser when Vite is ready, and stops both on Ctrl+C
  • Update README.md with a quick-start section pointing to ./start.sh (manual steps preserved in a <details> block)
  • Defer the getExamples() fetch until the welcome is dismissed — avoids a spurious "Load failed" error bar on cold start when the backend hasn't finished booting yet

Notes

  • This branch was cut from main at 80ca65b (before v2.1.0). All GUI/launcher changes are isolated to: frontend/src/App.tsx, frontend/src/App.css, frontend/src/pages/WelcomePage.tsx, frontend/public/logo.png, start.sh, README.md.
  • The README.md change will likely conflict with the recent tutorial-section additions — happy to rebase and resolve once you've had a look.
  • No backend / library code changed, so this should be orthogonal to the v2.1.0 Monte Carlo / Plant refactor.

Test plan

  • ./start.sh on a fresh clone bootstraps .venv (Python ≥3.10), installs backend deps, runs npm install
  • Backend (uvicorn :8000) and frontend (Vite :5173) both start; Ctrl+C stops both cleanly
  • Browser auto-opens to http://localhost:5173 once Vite is serving
  • Welcome screen renders with logo + feature list + Get Started button
  • Clicking Get Started reveals the main app with no error bar
  • Header shows the logo (no wordmark)
  • Examples dropdown loads case studies as before
  • Dark mode still works on both the welcome screen and the main app

🤖 Generated with Claude Code

- Replace "OpenPyTEA" wordmark in header with logo image
- Add welcome/splash page with feature overview and Get Started button
- Add start.sh: one-command launcher that bootstraps .venv + npm deps,
  starts backend + frontend, and opens the browser
- Update README with quick-start section
- Defer examples fetch until welcome dismissed to avoid spurious
  "Load failed" error on cold start

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@omoultosEthTuDelft omoultosEthTuDelft merged commit d179cfd into main Jun 10, 2026
4 checks passed
@omoultosEthTuDelft omoultosEthTuDelft deleted the gui-welcome-launcher branch June 10, 2026 10:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant