LockedIn

Focus on what matters.

A native, distraction-resistant goal governance, hierarchical task management, and target deadline countdown application built with pure SwiftUI for macOS.

_{Compatible with Apple Silicon (M1/M2/M3/M4) & Intel Macs running macOS 13.0+}

---

🌟 Overview

LockedIn is engineered to eliminate distraction and preserve relentless forward momentum on high-stakes outcomes that define your career, education, craft, and personal life.

Whether steering a doctoral dissertation, authoring a book, managing an engineering roadmap, passing licensing exams, or executing athletic training blocks, LockedIn enforces a strictly domain-neutral architecture. You will never find hardcoded academic assumptions or rigid taxonomy. The terminology adapts seamlessly to whatever outcome you choose to conquer.

Goal ──▶ Categories ──▶ Tasks & Subtasks ──▶ Live DD-MM-YYYY Countdown & Menu Bar Ticker

---

✨ Core Highlights

🎯 Domain-Neutral Data Architecture

• Goal: Any high-order outcome. Every goal is fully editable and displays an eye-catching glowing green effect when active. Active state is strictly goal-level.
• Target Deadline: The definitive target date formatted strictly as DD-MM-YYYY (e.g. 31-12-2026), driving live countdowns.
• Category: Flexible, user-colored grouping of tasks with visual completion rings.
• Milestone: Non-fungible checkpoints that visually anchor substantive progress.
• Task & Subtask: Granular work items with quick inline creation, optional deadlines (DD-MM-YYYY), status badges, and priorities (task-level active buttons removed in favor of automatic nearest-deadline resolution).
• Overall Progress: Mathematically computed, weighted completion across all leaf tasks.

🧭 Strict Three-Tab Navigation Paradigm

LockedIn maintains a clean, distraction-free environment organized into strictly three primary views:

1. Dashboard: Glowing green active goal card, live target countdown (DD-MM-YYYY), overall progress ring, nearest upcoming task card, and milestone tracker. No accidental blue startup focus squares.
2. Add Tasks: Structured 260pt goal sidebar with organized multi-row cards (Title + Active badge/button, full-width stats row preventing text wrapping, and direct 1-click Edit and Delete buttons), category accordions, and instant inline task quick-add (no dropdown arrows or 3-dots menus!).
3. Settings: Restructured preferences — active goal & deadline editing with single-line Switch Active Goal dropdown, System/Light/Dark appearance switcher (without intrusive blue borders), 5-second menu bar ticker configuration, custom notifications, launch-at-login, and JSON data backup/restore.

⏱️ Persistent, Always-On Menu Bar Extra

• The menu bar icon stays always on even if the main application window is closed.
• Reopen the app instantly at any time from the menu bar popover or Dock.

🔄 5-Second Alternating Menu Bar Ticker (Private Date-Only)

• Phase A (5 seconds): Displays overall goal target deadline (DD-MM-YYYY), remaining days ((142d)), and progress percentage.
• Phase B (5 seconds): Displays the date for the recent task with an icon ([checklist] DD-MM-YYYY (Xd)). The task title is kept strictly private and never exposed in the menu bar.
• Quick popover access to a mini-dashboard and upcoming tasks with a reliable native segmented switcher (Dashboard vs Tasks).

📅 Uniform DD-MM-YYYY Date Formatting Everywhere

Dates across all screens, countdown badges, task rows, form sheets, and menu bar extras are strictly formatted in the clean, international DD-MM-YYYY standard.

🗑️ Direct Delete Actions (No 3-Dots, No Dropdown Arrows)

All multi-step dropdown menus have been replaced with dedicated, direct 1-click Delete buttons across goals, categories, and tasks.

🎨 Clean, Native macOS Aesthetics

• Native macOS vibrancy without awkward blue borders on tab buttons, appearance pickers, or startup cards.
• Embedded high-resolution LockedIn icon branding throughout the interface.
• Three appearance preferences: System (follows macOS dynamically), Light, and Dark.

🔒 100% Offline-First & Private

• Zero cloud accounts, zero telemetry, zero background network calls.
• Atomic JSON persistence stored locally in ~/Library/Application Support/LockedIn/.
• Full backup export and restore in human-readable JSON.

---

🏗️ Architecture

LockedIn/
├── Package.swift                    # Swift Package Manager manifest
├── LockedIn.xcodeproj/              # Native Xcode Project (macOS 13.0+)
├── icon/
│   └── icon.png                     # Master 1024x1024 icon
├── scripts/
│   └── build_dmg.sh                 # Universal DMG build script (arm64 + x86_64)
├── LockedIn/
│   ├── App/
│   │   └── LockedInApp.swift        # @main entry point, Scene & Always-On MenuBarExtra
│   ├── Models/
│   │   ├── Goal.swift               # Root outcome model & progress logic
│   │   ├── Category.swift           # User-defined grouping model
│   │   ├── Task.swift               # Tasks, subtasks, milestones, statuses, deadlines
│   │   └── AppSettings.swift        # Appearance, notifications, preferences
│   ├── ViewModels/
│   │   └── AppViewModel.swift       # Central state store, active task toggles, 5s ticker
│   ├── Views/
│   │   ├── ContentView.swift        # Master container with 3 primary tabs & logo
│   │   ├── Dashboard/
│   │   │   └── DashboardView.swift  # Glowing active goal, progress ring, active task
│   │   ├── AddTasks/
│   │   │   ├── AddTasksView.swift   # Categories, inline task add, direct delete buttons
│   │   │   └── FormSheets.swift     # Modal builders for goals/categories/tasks
│   │   ├── Settings/
│   │   │   └── SettingsView.swift   # Grouped settings, goal editor, backup
│   │   ├── MenuBar/
│   │   │   └── MenuBarView.swift    # Lightweight menu bar popover
│   │   ├── Onboarding/
│   │   │   └── OnboardingView.swift # First-launch guided configuration
│   │   └── Shared/
│   │       ├── DesignSystem.swift   # Tokens, DD-MM-YYYY format, GlowingActiveBadge
│   │       └── AppIconAsset.swift   # Embedded high-res app icon view & provider
│   ├── Services/
│   │   ├── PersistenceService.swift # Atomic JSON read/write & backup engine
│   │   └── NotificationService.swift# UserNotifications dispatcher
│   ├── Assets.xcassets/             # AppIcon, AppLogo, MenuBarIcon, AccentColor
│   └── Info.plist                   # App configuration & bundle metadata
├── flow.md                          # Technical architecture & state machine
└── README.md                        # Documentation & contribution guide

---

⚡ Quick Start & Installation

Option 1: Direct Download (Recommended for all Mac users)

1. Download LockedIn-Universal.dmg (Universal binary for both Apple Silicon and Intel Macs).
2. Open the downloaded .dmg file.
3. Drag LockedIn.app into your Applications folder.
4. Launch LockedIn from Applications or Spotlight!

(If macOS displays an unverified developer prompt on first open, right-click LockedIn.app and choose Open, or allow it in System Settings > Privacy & Security).

---

Option 2: Build the Universal DMG from Source

git clone https://github.com/K-692/LockedIn.git
cd LockedIn

# Compile universal binary (arm64 + x86_64) and create DMG
./scripts/build_dmg.sh

---

Option 3: Build & Run from Command Line

# Clone the repository
git clone https://github.com/K-692/LockedIn.git
cd LockedIn

# Build the release executable
swift build -c release

# Launch LockedIn
.build/release/LockedIn

---

Option 4: Open in Xcode

open LockedIn.xcodeproj

Press Cmd + R in Xcode to build and run.

---

📊 Technical Specifications

Parameter	Specification
Minimum Deployment	macOS 13.0 (Ventura)
Tested On	macOS Sonoma (14.x) & macOS Sequoia (15.x)
Architecture	Apple Silicon (arm64) & Intel (x86_64) Universal
Frameworks	SwiftUI, AppKit, Combine, UserNotifications, UniformTypeIdentifiers
Storage Engine	Atomic serialized JSON with crash recovery
Date Format Standard	DD-MM-YYYY across all views
Menu Bar Mode	Always-On, Alternating 5-second ticker (Goal Countdown vs Private Task Date)
UI Paradigms	3-tab segmented navigation, Glassmorphism, Semantic Colors

---

🤝 Contributing

Contributions make the open-source community an inspiring place to learn, create, and build. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'feat: Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

📄 License

Distributed under the MIT License. See LICENSE for more information.

---

Built with ❤️ for focused creators, researchers, engineers, and achievers everywhere.