Architecture Overview

Project Categories

Hardware Projects

Philosophy: Minimal design, open source electronics

• esp32_minimal/ - ESP32 dev board with minimal components
• rp2040_minimal/ - RP2040 dev board with minimal components
• game-console/ - Handheld gaming device based on RP2040
• allwinner-h3_minimal/ - ARM Cortex-A7 Linux board
• pico_st7789/ - Display breakout board
• tars/ - Custom hardware project
• rockchip-rk3399_minimal/ - ARM64 Linux board

Stack: KiCad for PCB design, minimal BOM approach

Web Projects

Philosophy: Serverless-first, TypeScript, minimal dependencies

• mayphus.org/ - Personal website/blog (Astro + org-mode content)
• agents/ - AI agent platform
• vocabvibe/ - Vocabulary learning app
• travel-tango/ - Travel planning with AI
• slidesnap/ - Slide generation tool
• tangmeifa.com/ - Chinese learning platform

Stack: Cloudflare Workers, TypeScript, React/Astro, Tailwind CSS

Tooling & MCP

Purpose: Extend LLM capabilities, automate workflows

• emacs-mcp-server/ - Emacs integration for MCP
• llm-mcp-server/ - General LLM tooling

Stack: Python, Node.js, MCP protocol

Infrastructure

Purpose: Server deployment, networking, containerization

• infrastructures/ - FreeBSD, Linux configs, proxy setups

Stack: FreeBSD, Linux, LXD, Docker, networking tools

Content & CAD

• notes/ - Personal knowledge base using org-mode, publishes to mayphus.org
• CADs/ - FreeCAD mechanical designs

System Connections

Integration Patterns

Hardware ↔ Web:

• ESP32/RP2040 → HTTP/WebSocket → Cloudflare Workers
• Real-time sensor data streaming
• Web-based device configuration

Content Flow:

• notes/ → mayphus.org/ → Cloudflare Pages
• Automated content sync via org-mode

Development Tools:

• MCP servers bridge LLM ↔ Development environment
• Emacs as primary development interface

Design Principles

1. Minimal Complexity: Favor simple solutions over feature-rich ones
2. Open Source: All projects use open toolchains and formats
3. Serverless-First: Web projects deploy to edge computing
4. Documentation as Code: Content lives in version control
5. Cross-Platform: Hardware designs work across environments

Dependencies

Shared Libraries

• TypeScript across all web projects
• Tailwind CSS for styling
• Cloudflare Workers runtime

Tool Dependencies

• KiCad for hardware design
• FreeCAD for mechanical design
• Emacs + org-mode for content creation
• Git for version control across all projects

Deployment Architecture