Valheim Mac Mod Manager
Alpha

Crafting the first native Valheim mod manager on macOS for a gaming community left behind

shot-vmmm-desktop-lg-fullView-dashboard
The "What"

Look Ma, I Built That

The first native macOS mod manager for Valheim, engineered to eliminate the technical debt of manual file management. Leveraging the Thunderstore API and an agentic workflow, the app automates the fragile dependencies of installs, updates, and compatibility checks. It transforms a friction-heavy file system hack into a seamless GUI, letting users focus on the game rather than the directory.

Valheim Mac Mod Manager discover vibe code approach
Valheim Mac Mod Manager discover dark mode view
The "Why"

Nightly Haunted Vision

Valheim hit Mac in 2025, but the mod scene remained stuck in the dark ages. Existing workarounds were fragile and broke with every OS update. This project became a high-stakes playground for agentic development—the impulse: see if a "vibe coding" workflow could turn a late-night spark into a functional tool that finally bridges the gap for the Mac user base.

Role
Product Designer, Design Engineer
Team
Solo Project
Duration
Nov, 2025 – Ongoing 
Technologies
Figma, Windsurf AI (IDE), React, Tauri, GPT-5-Codex
Valheim mac mod manager original workaround instructions insights
Valheim mac mod manager manage dark mode view
Valheim mac mod manager discover list item detail modal light mode view
Valheim mac mod manager discover light mode view
Valheim mac mod manager primary action dark mode close-up view
The "How"

Nah, Let’s Fix That

Learning a niche software category on the fly required an experimental approach. Skipping traditional groundwork, the process jumped into "vibe coding" sessions to ensure the technical "brain" actually worked. Once functional, the focus shifted to Figma to give the tool the right feel. A component-first, auto-layout-heavy approach keeps the UI as modular as the mods it manages. Despite several "what-the-face" moments, adopting familiar manager patterns kept the experience anchored in a "simplicity first" philosophy.

Valheim mac mod manager design system components overview
Valheim mac mod manager Valheim build mood
Valheim mac mod manager design system sidebar footer measurements
Valheim mac mod manager design system sidebar header measurements
Valheim mac mod manager design system mod listing item component measurements
Reflections

Oh Well, Fair Point

This project was a complete departure from the "Standard UX Process." As an origin impulse experiment, the conscious trade-off was made to skip deep market research in favor of rapid prototyping to see if the agentic dev stack could handle native app complexity. While this led to some "build-measure-learn" moments that felt like a rollercoaster, it proved that for solo MVPs, momentum is often more valuable than a 40-page discovery document.

Valheim Mac Mod Manager Valheim gameplay mood
Next steps

Sure we’re done yet?

It’s just the beginning. The next steps involve getting first footsteps into AI-driven user testing to catch friction points I'm too close to see and an open-source launch via GitHub for a community-driven update model for all mac vikings to help maintain the ecosystem they play in and to show the community that Mac gaming is outgrowing a second-class experience.

Contact

Are you
a high-fiver?

handcrafted website