Valhalla: Nordheim Reborn from the Ashes

Valhalla: Secure Contact Database


Version: 1.0.0
Platform Support: Natively compiled for macOS and Linux

Valhalla is an enterprise-grade, local-first contact management database built from the ground-up for speed, stability, and extreme data privacy. Originally rearchitected from the ashes of Nordheim, Valhalla operates inside heavily isolated OS-level App Sandboxes to ensure that your sensitive Contact data is never intercepted.

🔒 Security Hardening & Zero-Trust Architecture

Valhalla is bound by strict ShadowAgent Security Compliance Policies, prioritizing data isolation and cryptographic verification above all else:

  • 100% Offline Payload: Valhalla contains zero telemetry pings, tracking analytics, or remote network calls. Once downloaded, it operates in an air-gapped vacuum.
  • Strict OS Sandboxing: The macOS application is isolated inside a restricted Apple App Sandbox with explicit user-selected file read/write entitlements. It physically cannot access your desktop or local documents without you firing a native Apple file-picker prompt perfectly validating your intent.
  • Auditable Supply Chain (SBOM): Packaged with a comprehensive CycloneDX Software Bill of Materials natively tracking all dependencies and sub-dependencies.
  • Deep Signature Verification: Every single binary, library, and framework payload inside Valhalla is deeply codesigned using an explicit Apple Distribution Certificate. Apple’s Gatekeeper validates the bundle architecture prior to execution to prevent malicious Dynamic Library (Dylib) injections.
  • Local Error Tracing: Errors do not ping anonymous crash-reporting servers. Valhalla intercepts obscure disk or file-parsing faults and stores them in a highly restricted persistent log strictly isolated in your machine’s Application Support directory, making external support diagnosis extremely safe and opt-in.

🛠️ Installation Guide

macOS

  1. Download the Valhalla_v1.0.0.dmg package.
  2. Double-click the .dmg to mount the installation layout.
  3. Drag the Valhalla.app icon directly onto the adjacent Applications folder shortcut.
  4. Launch Valhalla natively from your Launchpad!

Linux

Valhalla’s codebase supports standard native Flutter bindings for Debian builds. Please refer to your internal repository pipeline for specific .deb distribution instructions. The distributed files here are amd64 DEB, a SHA512 hashsum, the *.asc file, and the pubkey for verification of the files before installation.

🚀 Usage & Configuration

Initial Authentication

Valhalla comes pre-configured with a hardened bcrypt seeded admin account generated directly alongside the local SQLite tables on first boot:

  • Email: admin@example.com
  • Password: password

(We strongly advise entering the settings UI to generate your valid user email and password and remove the standard login credentials!)

The Database Structure

Valhalla uses sqlite3 backing local FFI dependencies to seamlessly compile SQL binaries on desktop processors natively. All tables (including Contacts, Users, and AuditLogs) are initialized securely at ~/Library/Application Support/com.example.valhalla/valhalla.db on macOS.

📄 Importing Contacts via CSV

Valhalla includes a heavily validated CSV Import engine for rapid organizational deployment mapping.

To ensure your contact payloads are ingested perfectly, your .csv file must strictly adhere to the following Header row definitions:

  • firstName (Required)
  • lastName (Required)
  • Company (Required)
  • Email (Required)
  • jobTitle (Optional – Null values safely skipped)

Important Rules for Importing:

  • Case-sensitivity does not apply to the header names; however, spacing must match (e.g. first Name will be rejected).
  • Rows missing any of the required columns will be skipped silently without halting the entire payload.
  • Upon completion, the system will output a dialog confirming exactly how many contacts successfully persisted into the database, alongside how many invalid rows were skipped.

🩺 Diagnostic Support & Troubleshooting

Because Valhalla blocks network tracking, resolving unexpected UI glitches or CSV File conflicts requires checking the local telemetry traces.

If you encounter an issue or an unexpected rejection while attempting to insert a .csv Contact manifest:

  1. Open Finder on macOS.
  2. Press Cmd + Shift + G and navigate to: ~/Library/Application Support/
  3. Locate the Valhalla folder (or com.example.valhalla).
  4. Read the valhalla_debug.log file in a simple text editor. It contains explicitly timestamped StackTraces documenting exactly why the application encountered a fault. You may submit this .log directly to the development team securely.