UNSEEN

the internal iOS app that explains it all

theunpartyunseen

An iOS 26+ native application for organizing, editing, and managing markdown documentation and UNPARTY service configurations

Repository Overview

theunpartyunseen (iOS Service Management App)

Location: unparty-app/theunpartyunseen
Status: Active Development
Primary Purpose: Mobile-first documentation management and service monitoring for the UNPARTY ecosystem

Tech Stack:

Framework: SwiftUI
Language: Swift 6.0
Platform: iOS 26.0+
Build Tool: Xcode Beta (16.0+)
Database: Local file system (JSON, Markdown, CSV)
Architecture: MVVM pattern with Observable macro

Key Features:

Markdown Editor: Full-featured editor with live preview, syntax highlighting, and split-screen mode
Service Dashboard: Monitor and manage UNPARTY services with real-time status indicators
Documentation Browser: Browse, search, and organize markdown files with intelligent categorization
Context-Aware Notes: Create project-specific notes organized by type (scripts, audits, budgets, growth, branding)
Quick Documentation Access: Direct links to service repositories and deployment URLs
CSV Data Management: Import, view, and analyze CSV usage data
JSON Import System: Advanced JSON data import with validation and analysis
Project Health Charts: Visual analytics for repository status and project metrics
Appearance Control: System, light, and dark mode support with per-user preferences
User Profiles: Asset tracking and profile-based configuration management

Architecture:

Code

iOS App (SwiftUI)
├── App Entry (unseenApp.swift)
├── Views
│   ├── UnpppView (Service Dashboard)
│   ├── ContextualMarkdownView (Editor)
│   ├── JSONImportDemoView (Data Import)
│   ├── ProjectHealthChart (Analytics)
│   └── UserProfileSelectionView (Profile Management)
├── Models
│   ├── Unppp (Service Configuration)
│   ├── Project (Repository Metadata)
│   ├── UserProfile (User Assets & Settings)
│   ├── Audit (Script Analysis)
│   └── RepoMetadata (Repository Statistics)
├── ViewModels (MVVM)
│   ├── UnpppViewModel (Service State)
│   ├── MarkdownViewModel (Editor State)
│   └── AuditViewModel (Analysis State)
├── Utils
│   ├── MarkdownManager (File Operations)
│   ├── CSVManager (Data Import)
│   ├── Constants (App Configuration)
│   └── Appearance (Theme Management)
└── Resources
    ├── Markdown/ (Bundled Documentation)
    ├── Unppps/ (Service Configurations)
    └── Assets.xcassets (Visual Assets)

Data Model:

Unppp: Service configuration with endpoint, GitHub URL, deployment status, and metadata
Project: Repository information with health metrics and execution analysis
UserProfile: User-specific assets including CSV files, markdown documents, and preferences
Audit: Script analysis with execution patterns, readiness scores, and error tracking
RepoMetadata: Comprehensive repository statistics including commit history and activity metrics

Integration Points:

GitHub: Direct repository links and metadata integration
UNPARTY Services: Dynamic service discovery via JSON endpoints
Local File System: Markdown, JSON, and CSV file management
theunpartyapi: Service configuration and metadata endpoint
Vercel Deployments: Service deployment status and URLs

Business Value

ABOUT: Understanding Your Ecosystem

Service Visibility: Real-time dashboard showing status of all UNPARTY services
Documentation Access: Instant access to technical documentation and guides
Health Metrics: Visual analytics showing project status and repository health
Asset Tracking: Comprehensive view of user-specific resources and configurations

BUILD: Creating and Organizing Content

Markdown Editor: Full-featured mobile editor with live preview and syntax highlighting
Context-Aware Notes: Organized note-taking system aligned with project types
JSON Data Import: Import and validate complex data structures with detailed analysis
CSV Management: Import and analyze usage data and metrics
Smart Saving: Intelligent file management with bundle vs. Documents directory handling

CONNECT: Sharing and Collaboration

Service Links: Direct access to GitHub repositories and deployed services
Documentation Sharing: Export and share markdown files
Configuration Sync: JSON-based configuration system for service discovery
Cross-Platform: Mobile access to documentation and services anywhere

Key Capabilities

1. Markdown Management

View Mode: Read-only display with AttributedString rendering
Edit Mode: Full markdown editor with monospace font
Live Preview: Side-by-side editor and preview panes
Smart Save: Bundle files save to Documents, existing files save in-place
Unsaved Changes Protection: Warning dialogs prevent data loss
Robust Rendering Pipeline: Steel-tight processing with preprocessing, primary parsing, and fallback rendering

2. Service Monitoring

Dynamic Service Discovery: Automatically fetches service configurations from theunpartyapi
Status Indicators: Real-time deployment status for each service
Quick Actions: One-tap access to GitHub repositories and live deployments
Priority Sorting: Services organized by priority and featured status
Cover Images: Visual identification with custom cover art

3. Data Import & Analysis

JSON Import System:
- File browser with document picker integration
- JSON validation and structure analysis
- Detailed import reports with field-by-field breakdown
- Error handling and recovery
CSV Data Management:
- Usage data import and validation
- Data transformation and analysis
- Export capabilities for processed data
Repository Statistics:
- Automated repo metadata generation
- Commit history analysis
- Activity tracking and metrics

4. Project Health Analytics

Visual Charts: SwiftUI Charts integration for health metrics
Readiness Scores: Script execution readiness tracking
Error Analysis: Comprehensive error categorization and reporting
Execution Patterns: Analysis of script behavior and outputs

5. User Profile System

Asset Tracking: User-specific CSV files, markdown documents, and configurations
Profile Selection: Switch between different user contexts
Preference Management: Per-user appearance and configuration settings
Update Tracking: Monitor changes to user assets over time

File System Architecture

Markdown File Locations

Development/Bundle: /unseen/unseen/Markdown/
Runtime/Sandbox: /var/mobile/Containers/Data/Application/.../Documents/Markdown/

The app searches both locations and prefers bundle files when duplicates exist.

Configuration Files

Service Config: /unseen/unseen/Unppps/UnpppsConfig.json
Event Data: /unseen/unseen/Unppps/events.json
Timeline Data: /unseen/unseen/Unppps/timeline.json
Repo Metadata: /unseen/unseen/Unppps/raw-repo-metadata.json

Bundled Documentation

Includes technical guides and reference documentation for UNPARTY services:

API overview and quick references
Service setup guides (bot, crawler, dashboard)
Architecture documentation
Development workflow guides
User profile and asset tracking documentation

Supported Markdown Formatting

Steel-Tight Processing Pipeline

Preprocessing: Fixes spacing, special characters, lists, line endings
Primary Parsing: Attempts AttributedString with full syntax support
Fallback Rendering: Custom parsing for edge cases and malformed markdown
Enhanced Display: Improved spacing, alignment, and typography

Formatting Support

Headers: H1-H6 with proper sizing and spacing
Lists: Bullet and numbered with consistent formatting
Inline Code: Monospace font with background highlighting
Bold Text: **bold** with proper weight
Italic Text: *italic* with proper styling
Special Characters: Smart quotes, dashes normalized
Emoji Spacing: Automatic spacing around emojis
Code Blocks: Monospace with background highlighting

Development Environment

Prerequisites

Xcode: Beta version (16.0+) - REQUIRED for iOS 26 features
macOS: 15.0+ (Sequoia) - Required for Xcode Beta
iOS SDK: 26.0+
Swift: 6.0+
Deployment Target: iOS 26.0 minimum

Apple Developer Account

Team ID: LL65276K8C
Bundle Identifier: app.unparty.unseen

Build Commands

Quick Build & Test

bash

# Build for iOS 26 simulator
xcodebuild build -project unseen.xcodeproj -scheme unseen \
  -destination 'platform=iOS Simulator,name=iPhone 16,OS=26.0'

# Run tests
xcodebuild test -project unseen.xcodeproj -scheme unseen \
  -destination 'platform=iOS Simulator,name=iPhone 16,OS=26.0'

# Clean and rebuild
xcodebuild clean build -project unseen.xcodeproj -scheme unseen

Analysis & Validation

bash

# SwiftLint (if available)
swiftlint --config .swiftlint.yml

# Xcode static analysis
xcodebuild analyze -project unseen.xcodeproj -scheme unseen \
  -destination 'generic/platform=iOS'

See BUILD.md for comprehensive build documentation.

Relationship to UNPARTY Ecosystem

Service Integration

theunpartyunseen serves as the mobile command center for the UNPARTY ecosystem:

Data Flow

Configuration Discovery: Fetches service configurations from theunpartyapi endpoints
Documentation Access: Bundles markdown guides for all major UNPARTY services
Repository Metadata: Imports and analyzes repository statistics
Health Monitoring: Tracks deployment status and service availability
User Assets: Manages user-specific CSV data and markdown documents

Cross-Repository Dependencies

theunpartyapi: Primary service configuration endpoint
theunpartyapp: Documentation and status monitoring
theunpartyrunway: Repository statistics and audit data
theunpartycrawler: Analytics metrics and usage data

Common Patterns

Investigation Workflow

Uses structured investigation approach consistent with other UNPARTY repositories:

Technical Investigation Reports (TIR) stored in markdown
Git-integrated tracking
Standardized commit messages
Documentation-first development

Documentation Standards

Maintains comprehensive documentation:

CLAUDE.md - AI assistance guidance and build commands
BUILD.md - Detailed build and deployment instructions
PARTY.md - One-sentence value and core features
README.md - This comprehensive overview
In-app markdown documentation for all services

Quality Enforcement

Type Safety: Swift 6.0 strict concurrency checking
SwiftLint: Code style enforcement (when configured)
Static Analysis: Xcode analyzer for potential issues
Build Validation: iOS 26 simulator testing
UI Testing: Comprehensive UI test suite

Project Structure

Source Organization

Code

unseen/
├── unseenApp.swift              # App entry point with splash screen
├── UnpppView.swift              # Main service dashboard
├── Item.swift                   # Generic item protocol
├── GenericItemComponents.swift  # Reusable UI components
├── MarkdownManager.swift        # File I/O operations
├── MarkdownViewModel.swift      # Editor state management
├── Components/                  # Reusable UI components
├── Models/                      # Data models and business logic
│   ├── ModelData.swift         # App-wide state
│   ├── Unppp.swift             # Service configuration
│   ├── UnpppViewModel.swift    # Service state management
│   ├── Project.swift           # Repository data
│   ├── UserProfile.swift       # User asset tracking
│   ├── Audit.swift             # Script analysis
│   └── RepoMetadata.swift      # Repository statistics
├── Views/                       # SwiftUI views
│   ├── ContextualMarkdownView.swift  # Markdown editor
│   ├── JSONImportDemoView.swift      # JSON import UI
│   ├── ProjectHealthChart.swift      # Analytics visualization
│   ├── UnpppListItemView.swift       # Service list item
│   └── UserProfileSelectionView.swift # Profile management
├── Utils/                       # Utilities and helpers
│   ├── Constants.swift         # App configuration
│   ├── Appearance.swift        # Theme management
│   ├── CSVManager.swift        # CSV data handling
│   └── NavigationOptions.swift # Navigation helpers
├── Scripts/                     # Build and automation scripts
│   └── generate-repo-stats.swift # Repository analysis
├── Markdown/                    # Bundled documentation
├── Unppps/                      # Service configurations
│   ├── UnpppsConfig.json       # Service definitions
│   ├── events.json             # Event data
│   ├── timeline.json           # Timeline data
│   └── raw-repo-metadata.json  # Repository metadata
└── Assets.xcassets/             # Visual assets

Test Structure

Code

unseenTests/            # Unit tests
unseenUITests/          # UI automation tests

Quick Start

For Developers

Clone the repository

bash

git clone https://github.com/unparty-app/theunpartyunseen.git
cd theunpartyunseen

Open in Xcode Beta
bash
open unseen.xcodeproj
Select iOS 26 Simulator
- Choose iPhone 16 or any iOS 26.0+ simulator
- Product → Build (⌘+B)
- Product → Run (⌘+R)
Explore the app
- View service dashboard
- Browse markdown documentation
- Test markdown editor with preview
- Try JSON data import

For Users

Note: Currently in active development. Not yet available on the App Store.

When Released:

Minimum iOS 26.0 required
Download from Apple App Store
Grant file access permissions for markdown editing
Configure user profile for asset tracking

Configuration

Service Configuration

The app uses a JSON-based configuration system for service discovery:

json

{
    "version": 1,
    "unppps": [
        {
            "id": "theunpartyapi",
            "name": "API",
            "priority": 4,
            "cover": "theunpartyapp-cover-001",
            "featured": true,
            "endpoint": "https://theunpartyapi.unparty.app/theunpartyapi.json",
            "gh": "https://github.com/unparty-app/theunpartyapi",
            "deployed": true,
            "deployed_url": "https://theunpartyapi.unparty.app",
            "description": "the store for data"
        }
    ]
}

Edit unseen/Unppps/UnpppsConfig.json to add or modify services.

User Profiles

User profiles track assets and preferences:

CSV data files
Custom markdown documents
Appearance preferences
Service configurations

See user-profile-asset-tracking.md for details.

Contributing

Development Workflow

Create a feature branch
Make focused, minimal changes
Test on iOS 26 simulator
Run static analysis
Update documentation if needed
Submit pull request

Commit Message Format

Follow standard commit conventions:

feat: for new features
fix: for bug fixes
docs: for documentation changes
refactor: for code refactoring
test: for test additions/changes

Code Style

Follow Swift 6.0 conventions
Use SwiftUI best practices
Maintain MVVM architecture
Add comments for complex logic
Use descriptive variable names

Troubleshooting

iOS 26 Simulator Issues

bash

# Verify iOS 26 simulators are available
xcrun simctl list devices available | grep "26.0"

# Check Xcode Beta installation
xcode-select -p

# Clean derived data
rm -rf ~/Library/Developer/Xcode/DerivedData/unseen-*

Build Issues

bash

# Clean and rebuild
xcodebuild clean build -project unseen.xcodeproj -scheme unseen

# Verbose build output
xcodebuild -project unseen.xcodeproj -scheme unseen build -verbose

File Access Issues

Grant file access permissions in Settings
Check Documents directory permissions
Verify bundle markdown files are included in target

See BUILD.md for comprehensive troubleshooting.

Roadmap

Current Focus

✅ Markdown editor with live preview
✅ Service dashboard and monitoring
✅ JSON data import system
✅ User profile and asset tracking
✅ Project health analytics

Planned Features

CloudKit sync for user data
Service health notifications
Advanced markdown features (tables, diagrams)
Export capabilities (PDF, HTML)
Widget support for service status
Siri shortcuts integration
iPad optimization
macOS companion app

Documentation

Core Documentation

CLAUDE.md - Build commands and development guide
BUILD.md - Comprehensive build documentation
PARTY.md - One-sentence value and core features
JSON_IMPORT_DOCUMENTATION.md - JSON import system guide
UNPPP-HEALTH-CHART-INTEGRATION.md - Health charts documentation

In-App Documentation

Located in unseen/Markdown/:

Service setup guides
API references
Architecture documentation
User guides
Development workflows

License

Team ID: LL65276K8C
Bundle ID: app.unparty.unseen

Contact & Support

Repository

GitHub: unparty-app/theunpartyunseen

UNPARTY Ecosystem

Web Platform: unparty.app
API: theunpartyapi.unparty.app
Organization: github.com/unparty-app

Acknowledgments

Built with:

SwiftUI - Apple's declarative UI framework
Swift 6.0 - Latest Swift with strict concurrency
iOS 26 - Next-generation iOS platform
Xcode Beta - Apple's integrated development environment

Part of the UNPARTY ecosystem, protecting creator ownership, privacy, and cost-sensitivity.

Status: 🚀 Active Development
Version: Pre-release
Platform: iOS 26.0+
Focus: Mobile-first documentation and service management for the UNPARTY ecosystem