Super Modern Popup App

A lightweight desktop popup application built with Tkinter.

Turkish documentation: README_TR.md

Features

• Simple and modern interface
• Name-based greeting popup
• File logging for app and popup interactions
• Platform-aware log directory selection for Linux, macOS, and Windows

Project Structure

PopUp-App/
├── app/
│   ├── main.py
│   ├── services/
│   │   └── logging_setup.py
│   └── ui/
│       └── popup_ui.py
├── tests/
│   ├── test_logging_setup.py
│   └── test_smoke.py
├── .github/workflows/ci.yml
├── .github/workflows/release.yml
├── .github/RELEASE_TEMPLATE.md
├── .github/release.yml
├── popupapp.py
├── Dockerfile
├── install.txt
├── dev-install.txt
├── CHANGELOG.md
├── README.md
└── README_TR.md

Requirements

• Python 3.10+
• Tkinter (on Linux, you may need python3-tk)

Install runtime dependencies:

python3 -m pip install -r install.txt

Run Locally

python3 popupapp.py

Tests

python3 -m pip install -r dev-install.txt
pytest -q

Build Linux Binary with Docker

docker build -t popup-app-builder .
docker run --rm -v "$PWD/output:/output" popup-app-builder

Generated file: output/popupapp-linux

Log File Locations

• Linux: ~/.local/share/super_popup_app/app_log.txt
• macOS: ~/Library/Application Support/super_popup_app/app_log.txt
• Windows: %APPDATA%\\super_popup_app\\app_log.txt

CI

The GitHub Actions workflow runs on every push and pull request and:

• performs syntax/import checks
• runs pytest
• validates on ubuntu-latest, macos-latest, and windows-latest
• builds Linux binary via PyInstaller
• uploads popupapp-linux as workflow artifact

Release

• Tag format: vMAJOR.MINOR.PATCH (example: v0.1.0)
• Release workflow: .github/workflows/release.yml
• Release template: .github/RELEASE_TEMPLATE.md
• Changelog source: CHANGELOG.md

Create and push a tag:

git tag v0.1.0
git push origin v0.1.0

License

MIT (LICENSE)