maneshtrader/README.md

1.5 KiB

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 source
  • mac/src/: Xcode macOS shell app (WKWebView host)
  • scripts/: build and packaging scripts
  • docs/: architecture and supporting docs
  • skills/: reusable project skills

Web Source

  • web/src/app.py: Streamlit entrypoint and UI orchestration
  • web/src/web_core/: strategy/data/chart/export modules
  • web/src/requirements.txt: Python dependencies
  • web/src/ONBOARDING.md: in-app onboarding guide content

macOS Shell

  • Project location: mac/src/ (*.xcodeproj auto-discovered by scripts)
  • Uses WKWebView and 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.