theunpartylogger

Location: /Users/UNPARTYLLC/theunpartylogger/
Status: Active Development
Primary Purpose: Advanced logging framework and component visualization system for macOS development

Overview

theunpartylogger is a sophisticated logging and diagnostic framework designed for macOS applications. It provides a unified, visual approach to understanding application behavior through structured logging, component relationship tracking, and real-time visualization dashboards.

This framework helps developers quickly identify issues, track component relationships, and understand system behavior through a beautiful, UNPARTY-branded interface.

Tech Stack

• Framework: SwiftUI
• Language: Swift 5.0
• Platform: macOS 11+
• Architecture: MVVM (Model-View-ViewModel)
• Build Tool: Xcode
• Data Persistence: SwiftData (in-memory)
• Key Technologies:
  • AppKit integration for native macOS experience
  • SwiftUI for modern, declarative UI
  • Structured logging with categorization
  • Real-time performance metrics

Key Features

1. UnpartyLogger - Unified Logging System

A comprehensive logging framework with multiple log levels and categories:

Log Types:

• 🔵 START - Process initiation
• ✅ SUCCESS - Successful operations
• ℹ️ INFO - Informational messages
• ❌ ERROR - Error conditions
• ⚠️ WARNING - Warning messages
• 🔍 DEBUG - Debug information
• 👋🏿 WELCOME - Initialization messages
• 💀 FATAL - Critical failures
• 🪩 PARTY - UNPARTY-specific events

Log Categories:

• NETWORK - Network requests/responses
• UI - User interface events
• DATA - Data operations
• AUTH - Authentication/authorization
• SYSTEM - System-level events
• PERF - Performance metrics
• DEBUGGER - Debugging operations
• PARTY - UNPARTY ecosystem events
• USER - User actions
• FATAL - Critical system failures

2. Component Network Visualization

Visual representation of application components and their relationships:

• Component node graph with interactive connections
• Data flow visualization
• Component metrics tracking
• Evolution tracking over time
• Network analytics dashboard

3. Interactive Log Viewer

Real-time log viewing with advanced filtering:

• Filter by log type (START, SUCCESS, ERROR, etc.)
• Filter by category (SYSTEM, NETWORK, DATA, etc.)
• Search across all log fields
• Timestamped entries with source location
• Beautiful, terminal-inspired design with UNPARTY color scheme

4. Performance Measurement

Built-in performance tracking and metrics:

• Automatic duration measurement
• Average, min, max statistics
• Per-operation performance tracking
• Performance report generation
• Integration with logging system

5. Setup Guide System

Interactive onboarding and setup tracking:

• Task completion checklist
• Progress visualization
• Setup window management
• Guided developer onboarding

6. Diagnostic Analysis

Automatic diagnostic generation from logs:

• Pattern recognition in log messages
• Feature extraction from diagnostics
• Integration with component tracking
• Automated troubleshooting assistance

Architecture

UnpartyLogger (macOS App)
├── Core Logging System
│   ├── UnpartyLogger (Singleton)
│   ├── MessageLogger (Legacy support)
│   ├── LogType (Type definitions)
│   └── LoggerAudit (Usage tracking)
├── Component Tracking
│   ├── ComponentEvolutionTracker
│   ├── ComponentNetworkView
│   ├── ComponentNode
│   ├── ComponentExplorer
│   ├── ComponentMetadata
│   └── Network Analytics
├── Visualization Layer
│   ├── LogViewer (Table-based log display)
│   ├── ComponentNetworkView (Graph visualization)
│   ├── InfoPanelView (Component details)
│   ├── DataFlowView (Flow visualization)
│   └── ComponentMetricsCard (Metrics display)
├── UI Components
│   ├── DashboardBackgroundView
│   ├── ComponentNetworkBackgroundView
│   ├── LogViewerBackgroundView
│   └── FloatingPanel
└── App Infrastructure
    ├── TabView Navigation
    ├── AboutWindowView (Setup Guide)
    ├── ContentView (Main Dashboard)
    └── SwiftData Model Container

Usage

Basic Logging

// Import the global convenience functions
import UnpartyLogger

// Simple logging
uInfo("User logged in successfully", category: .auth)
uError("Failed to connect to server", category: .network)
uSuccess("Data saved successfully", category: .data)
uWarning("Low memory condition", category: .system)
uDebug("Processing component relationships", category: .debugger)
uParty("Component visualization initialized", category: .party)

// Network logging
UnpartyLogger.shared.logNetwork(
    request: "GET /api/users",
    response: "200 OK",
    error: nil
)

// Performance measurement
let result = await UnpartyLogger.shared.measure("DataSync") {
    await syncDataOperation()
}

Viewing Logs

The application provides three main tabs:

1. Dashboard - Overview and quick actions
2. Components - Visual component relationship explorer
3. Logs - Real-time log viewer with filtering

Logs can be filtered by:

• Type (START, SUCCESS, ERROR, etc.)
• Category (SYSTEM, NETWORK, DATA, etc.)
• Search text across all fields

Visual Design

The application features a stunning UNPARTY-branded design with three distinct themes:

Dashboard Theme

• Dark gradient background (deep purple to blue)
• Animated orbital rings
• Radial glows in electric pink and blue
• Grid pattern overlay

Component Network Theme

• Network grid visualization
• Data flow particles
• Electric purple and blue accents
• Vignette effects for depth

Log Viewer Theme

• Terminal-inspired dark gray background
• Simulated code patterns
• Monospaced fonts
• Color-coded syntax highlighting

UNPARTY Color Palette:

• Electric Purple: rgb(153, 51, 230)
• Neon Pink: rgb(255, 26, 153)
• Electric Blue: rgb(51, 153, 255)
• UNPARTY Yellow: rgb(230, 204, 26)

Integration Points

Internal

• SwiftData: Model persistence and state management
• AppKit: Native macOS window management
• SwiftUI: Modern declarative UI framework

Planned External

• Vercel API: Log aggregation and remote storage
• Component Registry: Cross-application component tracking
• Analytics Pipeline: Performance metrics collection

Business Value

ABOUT (Understanding)

• Comprehensive Visibility: Understand application behavior through structured, categorized logging
• Component Relationships: Visualize how different parts of the system interact
• Performance Insights: Track and analyze performance metrics across operations
• Pattern Recognition: Automatically identify common issues and patterns

BUILD (Creation)

• Developer Tools: Provide developers with powerful debugging and diagnostic tools
• Rapid Debugging: Quickly identify and isolate issues through filtered log viewing
• Component Evolution: Track how components change and evolve over time
• Quality Assurance: Built-in audit logging and usage tracking

CONNECT (Sharing)

• Visual Dashboards: Beautiful, shareable visualizations of system behavior
• Export Capabilities: Log data can be extracted and shared with team members
• Cross-Application Tracking: Foundation for ecosystem-wide component tracking
• Documentation Aid: Logs serve as living documentation of system behavior

Relationship to Ecosystem

Integration with Other UNPARTY Repositories

theunpartyapp (Web Platform):

• Shares logging philosophy and structure
• Could integrate for cross-platform log aggregation
• Common component tracking framework

theunpartyunppp (Native App):

• Similar SwiftUI architecture
• Shared logging patterns
• Component visualization techniques

theunpartyrunway (Dev Automation):

• Provides logging data for development velocity tracking
• Component evolution feeds into architecture documentation
• Performance metrics support cost analysis

theunpartycrawler (Analytics Intelligence):

• Log data could be analyzed for behavioral patterns
• Component relationships inform dependency analysis
• Performance metrics feed analytics pipeline

Data Flow

theunpartylogger
├── Generates → Structured logs with metadata
├── Tracks → Component relationships and evolution
├── Measures → Performance metrics
└── Provides → Real-time visualization dashboards
    │
    ├── To → Development team (debugging)
    ├── To → theunpartyrunway (velocity tracking)
    └── To → theunpartycrawler (analytics)

Development Setup

Prerequisites

• macOS 11.0 or later
• Xcode 12.0 or later
• Swift 5.0 or later

Building the Project

# Clone the repository
git clone https://github.com/unparty-app/theunpartylogger.git
cd theunpartylogger

# Open in Xcode
open unparty.xcodeproj

# Build and run
# Use Cmd+R in Xcode or:
xcodebuild -scheme unparty -configuration Debug build

Project Structure

theunpartylogger/
├── Logger/
│   └── Core/
│       ├── MessageLogger.swift
│       ├── LogType.swift
│       ├── LoggerAudit.swift
│       ├── LoggerAuditUsageExample.swift
│       └── UnpartyLogger/
│           ├── UnpartyLogger.swift
│           ├── ComponentEvolutionTracker.swift
│           ├── ComponentNetworkView.swift
│           ├── ComponentNode.swift
│           ├── ComponentExplorer.swift
│           ├── ComponentMetadata.swift
│           ├── ComponentMetricsCard.swift
│           ├── ComponentListView.swift
│           └── NetworkComponents/
│               ├── NetworkAnalytics.swift
│               ├── NodeView.swift
│               ├── InfoPanelView.swift
│               └── DataFlowView.swift
├── unparty/
│   ├── unpartyApp.swift (App entry point)
│   ├── ContentView.swift
│   ├── AboutViewModel.swift
│   ├── Item.swift
│   ├── AboutWindowView.swift
│   ├── Navigation/
│   │   └── FloatingPanel.swift
│   ├── Font/
│   ├── Assets.xcassets
│   ├── Info.plist
│   └── unparty.entitlements
├── unpartyTests/
├── unpartyUITests/
├── PARTY.md
└── README.md (this file)

Current State

✅ Core Features Implemented:

• Unified logging system with multiple types and categories
• Interactive log viewer with filtering and search
• Component network visualization
• Performance measurement and metrics
• Beautiful UNPARTY-branded UI themes
• Setup guide system
• Diagnostic analysis framework

⚠️ In Progress:

• Vercel API integration for remote log storage
• Cross-application component tracking
• Enhanced analytics and reporting
• Export capabilities for logs and metrics

🔮 Planned Enhancements:

• Real-time log streaming from multiple sources
• Machine learning-based pattern detection
• Integration with CI/CD pipelines
• Cloud-based log aggregation service
• Mobile companion app for iOS
• Browser extension for web log capture

Contributing

This repository is part of the UNPARTY ecosystem. When contributing:

1. Follow the existing code style and patterns
2. Use the structured logging system for all output
3. Add appropriate log categories for new features
4. Update component tracking when adding new modules
5. Maintain the UNPARTY visual design language
6. Test on macOS 11+ before submitting

Philosophy

theunpartylogger embodies the UNPARTY philosophy of creator ownership, privacy, and cost-sensitivity:

Creator Ownership

• Developers own their log data
• Complete control over what gets logged
• Local-first architecture with optional cloud sync

Privacy

• No tracking or telemetry by default
• Sensitive data can be filtered from logs
• All log storage is under user control

Cost-Sensitivity

• Efficient, lightweight logging system
• Minimal performance overhead
• Optional remote storage only when needed
• No required external services

License

Part of the UNPARTY ecosystem.
© 2025 UNPARTY LLC. All rights reserved.

Related Documentation

• PARTY.md - One-sentence value proposition and core features
• unparty/AboutWindowView.swift - Setup guide implementation
• Logger/Core/UnpartyLogger/UnpartyLogger.swift - Core logging system
• Logger/Core/LogType.swift - Log type definitions and protocols

Ecosystem Context

Repository: 5 of 36 in the UNPARTY ecosystem
Category: 🛠️ Developer Tools
Primary Users: Developers, QA Engineers, DevOps
Integration Level: Foundation (supports all other repositories)

Last Updated: 2025-10-29
Maintained By: UNPARTY LLC Development Team
Status: 🚀 Active Development

One-Sentence Value:

theunpartylogger provides developers with a beautiful, powerful logging and diagnostic framework that makes understanding application behavior intuitive through visual dashboards and structured categorization.