Brand Asset Manager

Desktop app for managing brand assets, automating media editing, and multi-platform publishing.

Built with: Sveltronkit (Electron + SvelteKit) + shadcn-svelte + Cagent AI
Optimized for: TRAE (Claude Code) development with MCP servers
Special: Zero Docker required - uses lightweight Python venv or Pydantic sandbox

🚀 Quick Start

# Clone
git clone https://github.com/alchimie-di-circe/brand-asset-manager
cd brand-asset-manager

# Install + setup Cagent
pnpm install
pnpm run setup-cagent

# Dev
pnpm start

# TRAE Development (VS Code + Claude Code)
# .mcp.json auto-loads Svelte MCP + DevServer MCP

📋 What's Inside

Core Architecture

• Electron Forge - Native app framework
• Svelte 5 Runes - Reactive frontend
• shadcn-svelte - 60+ UI components
• SQLite + Prisma - Local database
• Cagent (AI) - Multi-agent content processing

AI-Assisted Development

• Svelte MCP Server - Real-time docs + autofixer
• DevServer MCP - Error monitoring + validation
• TRAE Custom Agents - Component builder, error detective, form expert

No Docker!

• Phase 0: Python venv (auto-setup, 300MB)
• Phase 2+: Pydantic AI Sandbox (secure, 100MB)
• macOS: Optional Apple Container (fast, 90ms startup)
• Cloud: Optional E2B (premium tier)

📚 Documentation

• PRD v2.0 - Full Specification
• NO Docker Strategy - 5 execution approaches
• MCP Integration Guide - Using Svelte + DevServer MCP
• Architecture Deep Dive - System design

🎯 Features

✅ Extract - Import from macOS Photos app with EXIF data
✅ Organize - Brand-based folder structure + metadata
✅ Edit - Cloudinary integration (upscale, bg removal, captions)
✅ Publish - Multi-platform scheduling (Instagram, Facebook, LinkedIn, etc.)
✅ Automate - AI-generated captions, hashtags, optimal posting times
✅ Archive - Local backup + version history

🔌 MCP Servers

This project uses MCP (Model Context Protocol) for AI-assisted development:

# Auto-loaded from .mcp.json
- Svelte MCP: Real-time Svelte 5 + SvelteKit docs
- DevServer MCP: Vite error monitoring + validation

Use with: Claude Code (TRAE) / Cursor / Copilot

📊 Tech Stack

🔐 Security

✅ Context isolation enabled (Electron)
✅ Local data only (SQLite)
✅ No telemetry (opt-in only)
✅ Secrets in .env.local (never committed)
✅ Sandboxed Cagent execution (Phase 2+)

📦 Distribution

# Build DMG for macOS
pnpm run make

# Creates brand-asset-manager-0.0.1.dmg
# Signed + notarized (requires Apple Developer account)

🤝 Contributing

This project uses TRAE (Claude Code) for development. Most features are built with AI assistance.

Development Workflow

1. Open in VS Code
2. Launch Claude Code (with .mcp.json loaded)
3. "Create component that..."
4. Claude queries Svelte MCP for docs
5. DevServer MCP catches errors in real-time
6. Validated code produced in <1 iteration

📄 License

MIT - See LICENSE file

🎓 Learning Resources

• Sveltronkit GitHub
• SvelteKit Docs
• shadcn-svelte Components
• Electron Forge Docs
• Prisma Docs

Made with ❤️ by Alchimie di Circe
Optimized for San Felice Circeo, Italy