Goalbound — Cybernetic Telemetry & Goal Tracking Desktop Application

Goalbound is a desktop HUD and mission control application built with Electron, SQLite (WebAssembly), and a WebGL Snowfall Shader. It combines long-range goal telemetry with native Bikram Sambat (Nepali Calendar) scheduling.

---

Features

• Massive Central Countdown HUD

  • High-precision countdown timer (Days, Hours, Minutes, Seconds).
  • Target epoch date display and remaining progress telemetry bar.
  • Secondary active trajectory switcher.
  • Clean zero-state when no active goals are present.

• Atmospheric WebGL Snowfall Shader

  • GPU-accelerated 4-layer depth parallax snowfall shader.
  • Optical bokeh, sinusoidal wind gust dynamics, and particle scintillation.
  • Runs at locked 60fps with zero CPU load.

• Unified Single-Page Application (SPA) Slider

  • Instantaneous horizontal slide transition between Dashboard HUD and Archive & Settings.
  • Touch swipe, mouse-drag, and trackpad gesture support.
  • Zero page reloads, zero black/white screen flashes.

• Bikram Sambat (BS) Calendar Integration

  • Full support for Nepali calendar years (2070–2095 BS) and variable month lengths.
  • Synchronous AD $\leftrightarrow$ BS date conversion.
  • Dynamic Bikram Sambat date pickers in all configuration modals.

• Three Dedicated Directives & Records

  • Goals: Long-term objectives with deadline trajectories (active, completed, expired).
  • Important Days: Single-day milestones or multi-day series (e.g. 1–10 days) with dedicated Today's Event & Upcoming Days side widgets.
  • Important Notes: System guidelines, architectural rules, and directives.

• Persistent SQLite Database

  • WebAssembly SQLite (sql.js) with persistent file storage in the user's application data directory.
  • Real-time inter-process communication (IPC) broadcast events.
  • Zero default seeding for a completely clean start.

---

Tech Stack

• Runtime: Electron.js
• Database: SQL.js (WebAssembly SQLite)
• Rendering & Shaders: WebGL GLSL ES 1.0 (Fragment/Vertex Shaders)
• UI & Styling: HTML5, Tailwind CSS, Material Symbols, Geist & JetBrains Mono typography
• Calendar Engine: nepali-date-converter
• Packaging: electron-builder (Windows .exe, NSIS Installer, Portable)

---

Project Structure

track task electron/
├── main.js                   # Electron main process & IPC handlers
├── preload.js                # Secure Context Bridge & synchronous Nepali API
├── index.html                # Unified SPA (Dashboard, Archive & Modals)
├── package.json              # App configuration & build scripts
├── .gitignore                # Git exclusions
├── src/
│   ├── db/
│   │   └── database.js       # SQLite database service & schema
│   └── services/
│       └── nepaliDateService.js # Calendar conversion utilities
└── dist/                     # Generated Windows .exe binaries

---

Getting Started

Prerequisites

• Node.js (v18 or higher recommended)
• npm

Installation

# Clone the repository
git clone <repo-url>
cd "track task electron"

# Install dependencies
npm install

Running in Development

# Launch the application in fullscreen mode
npm start

Packaging & Compiling to Windows .EXE

# Build standalone Windows executables (Portable & Installer) into dist/
npm run dist

# Create unpacked application directory in dist/win-unpacked/
npm run pack

---

Navigation & Gestures

Action	Gesture
Slide to Archive / Settings	Swipe Left or Drag Left on Dashboard
Slide to Dashboard HUD	Swipe Right or Drag Right on Archive
Quick Edit Any Record	Double-Click record card in Archive
Quick Delete Any Record	Swipe Left on record card
Close Open Modal	Press Escape or click backdrop

---

License

This project is licensed under the MIT License.