Add local app launcher script

Author: utkarsh0493

README.md

@@ -42,6 +42,22 @@ It showcases:
 - CSV, JSON, HTML, and Markdown exports
 - Local output saving under `Computations/Results`
 
+## Screenshots
+
+> Screenshots will be added as the interface matures.
+
+### Project overview
+
+![Project overview](CodeDocumentations/images/project_overview.png)
+
+### File index
+
+![File index](CodeDocumentations/images/file_index.png)
+
+### Reproducibility report
+
+![Reproducibility report](CodeDocumentations/images/reproducibility_report.png)
+
 ## Project structure
 
 ```text
@@ -60,4 +76,13 @@ FSS-Navigator-App/
 ├── logs/
 ├── environment.yml
 ├── requirements.txt
-└── README.md
+└── README.md
+```
+
+## Run the app
+
+Recommended:
+
+```bash
+python run_app.py
+```

run_app.py

@@ -0,0 +1,32 @@
+"""
+Launcher for FSS Navigator App.
+
+Run with:
+
+python run_app.py
+"""
+
+import subprocess
+import sys
+from pathlib import Path
+
+
+APP_PATH = Path("Computations/Code/app/app.py")
+
+
+def main() -> None:
+    """
+    Launch the local Streamlit app.
+    """
+
+    if not APP_PATH.exists():
+        raise FileNotFoundError(f"Could not find app file: {APP_PATH}")
+
+    subprocess.run(
+        [sys.executable, "-m", "streamlit", "run", str(APP_PATH)],
+        check=True,
+    )
+
+
+if __name__ == "__main__":
+    main()