WE

WE is a decentralized application framework and design system built on AD4M. It provides everything needed to build dynamic, schema-driven web applications with multiple launcher implementations (web, Electron, Tauri) and a comprehensive component library.

Quick Start

# Setup workspace (validates seed, builds packages, generates configs)
pnpm setup

# Start development
pnpm dev:web       # Web development server
pnpm dev:electron  # Electron app
pnpm dev:tauri     # Tauri app

Documentation

• DEVELOPER_SETUP.md - Complete setup guide, commands, and workflows
• SEED-SYSTEM.md - Seed file architecture, configuration, and examples
• LAUNCHER-UI-CUSTOMIZATION.md - Customizing boot screen, settings, and launcher UI

Workspace Structure

Packages

• @we/app-framework - Core framework for building WE launcher applications with platform adapters, stores, and SolidJS integration
• @we/schema-renderer - Framework-agnostic schema-driven UI renderer with support for layouts, routing, and dynamic data
• @we/design-system - Complete design system with tokens, themes, elements, components, widgets, pages, and templates
• @we/block-composer - Block-based content composition system
• @we/models - Shared TypeScript types and interfaces
• @we/cli - Command-line tools and build utilities
• @we/utils - Shared utility functions

Apps

• @we/app-web - Web launcher application (browser-based)
• @we/app-electron - Electron desktop launcher (Linux, macOS, Windows)
• @we/app-tauri - Tauri desktop launcher (Rust-based)
• playgrounds - Development playgrounds for testing components and features

Features

Launcher System

• Single Source of Truth: Configure everything via we-seed.json
• Multi-Platform: Web, Electron, and Tauri support
• App Modes: Automatic layout switching (single app vs multi-app)
• White-Labeling: Fully customizable launcher UI via seed configuration
• Auto-Generation: Platform-specific configs generated from seed file

Framework & Design System

• Schema-Driven UI: Build interfaces from JSON schemas with @we/schema-renderer
• Component Library: Comprehensive design system with tokens, themes, and components
• Platform Adapters: Abstract platform differences for web, Electron, and Tauri
• AD4M Integration: Built-in stores and utilities for decentralized apps
• Framework Support: SolidJS with planned React support

Development

# Validate seed configuration
pnpm validate

# Build all packages
pnpm build

# Build for production
pnpm build:web
pnpm build:electron
pnpm build:tauri

Support

For issues or questions, please open an issue on GitHub.