| docs | ||
| mac/src | ||
| scripts | ||
| skills/macos-selfcontained-webapp | ||
| web | ||
| .gitignore | ||
| Makefile | ||
| README.md | ||
| Run App.command | ||
| run.sh | ||
Real Bars vs Fake Bars Trend Analyzer
A Python web app wrapped by a native macOS shell.
Standardized Layout
web/src/: web backend + Streamlit app sourcemac/src/: Xcode macOS shell app (WKWebViewhost)scripts/: build and packaging scriptsdocs/: architecture and supporting docsskills/: reusable project skills
Web Source
web/src/app.py: Streamlit entrypoint and UI orchestrationweb/src/web_core/: strategy/data/chart/export modulesweb/src/requirements.txt: Python dependenciesweb/src/ONBOARDING.md: in-app onboarding guide content
macOS Shell
- Project location:
mac/src/(*.xcodeprojauto-discovered by scripts) - Uses
WKWebViewand launches embedded backend executable from app resources. - No external browser required.
See mac/src/README.md for shell details.
Setup
Quick start
./run.sh
Setup only
./run.sh --setup-only
Tests
make test
Build Self-Contained macOS App
./scripts/build_selfcontained_mac_app.sh
Output: dist-mac/<timestamp>/<Scheme>.app
Package as DMG:
APP_BUNDLE_PATH="dist-mac/<timestamp>/<Scheme>.app" ./scripts/create_installer_dmg.sh
Output: build/dmg/<AppName>-<timestamp>.dmg
Optional Standalone Streamlit App
./scripts/build_standalone_app.sh
Output: dist-standalone/<timestamp>/dist/<RepoName>.app
Notes
- Analysis-only app; no trade execution.
- Yahoo Finance interval availability depends on symbol/lookback.
- For broad distribution, use code signing + notarization.