Repository navigation
Building & Packaging From Source
mlgitdev edited this page Oct 27, 2026
·
4 revisions
NewsAlerts compiles into a lightweight, standalone native binary (~14 MB) embedding all HTML/CSS/JS assets, custom icons, and audio files.
The repository includes a Universal Cross-Platform Makefile compatible with Windows, macOS, and Linux:
# Clone the repository
git clone https://github.com/mlgitdev/NewsAlerts.git
cd NewsAlerts
# Auto-detect OS & prepare virtual environment with all dependencies
make env
# Or explicit platform-specific setup:
# make env-win # Windows
# make env-linux # Linux
# make env-mac # macOS
# Compile dual build (portable .exe + unpacked app folder)
make build
# Launch the portable standalone binary
make run
# Launch the unpacked app directory (instant sub-300ms startup)
make run-app
# Install to %LOCALAPPDATA%\Programs\NewsAlerts with Start Menu & Desktop shortcuts
make install-local
# Compile Inno Setup Windows installer (NewsAlerts-Setup-v*.exe)
make installer
# Run full automated unit tests
make test
# Execute Deterministic Package Verification Gate
make verify
# Audit for accidental secret or credential leaks
make check
# List open GitHub issues (Issue-First Protocol)
make issue-list
# Inspect specific issue details and discussion
make issue-view ISSUE=<number>NewsAlerts provides two distinct distribution formats:
-
Portable Standalone Executable (
dist\NewsAlerts.exe): Single-file archive (~15 MB) for USB drives or drop-in use. -
Unpacked Application Directory (
dist\NewsAlerts-App\): Pre-extracted folder (~29.6 MB) bypassing%TEMP%extraction and real-time antivirus scans for sub-300ms instant terminal startup. -
Inno Setup Windows Installer (
NewsAlerts-Setup-vX.Y.Z.exe): Modern LZMA2 installer (~13.5 MB) deploying directly to%LOCALAPPDATA%\Programs\NewsAlertswithout requiring Administrator privileges.
Before any release artifact is accepted or published:
- Binary PE magic headers are validated.
- File size thresholds are checked (must remain under 25 MB).
- Secrets and private key patterns are verified absent from the compiled archive.
- Python byte-compilation check passes cleanly with zero syntax errors.
NewsAlerts v2.12.0 · Institutional Trading Terminal · Maintained by @mlgitdev · GitHub Repository · Wiki Home