verekia-architecture

Define Miniplex ECS architecture separating systems and views for R3F games.

31|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/verekia/r3f-gamedev --skill verekia-architecture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: verekia-architecture
Source: https://github.com/verekia/r3f-gamedev/tree/main/skills/verekia-architecture
Command: npx skills add https://github.com/verekia/r3f-gamedev --skill verekia-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill codifies the day-to-day coding style and patterns for building React Three Fiber games using a Miniplex ECS, emphasizing a clear separation between game logic and the render layer to improve maintainability and testability.

Core Features & Use Cases

  • Headless-first architecture with a strict separation of Systems (logic) and Views (rendering), enabling testing without a renderer.
  • Miniplex-based data flow and queries that drive deterministic updates, entity mutations, and predictable world state.
  • ModelContainer pattern that connects entity data to dumb view components, keeping models reusable and testable across scenes.

Quick Start

Refactor your R3F project to place all game logic into Systems and keep React components as pure Views.

Frequently Asked Questions about verekia-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I separate game logic from rendering in React Three Fiber?

To separate game logic from rendering in React Three Fiber, place all game logic into Systems and keep React components as pure Views. This architecture uses Miniplex ECS to enforce a strict boundary, improving maintainability and testability.

What is the best way to architect an R3F game using ECS patterns?

The best way to architect an R3F game using ECS patterns is adopting a headless-first approach with Miniplex. This methodology drives deterministic system updates and entity mutations through data queries, ensuring a predictable and decoupled world state.

Does Miniplex support headless testing without a renderer?

Yes, Miniplex supports headless testing without a renderer. The architecture enforces a strict separation between Systems and Views, allowing you to test game logic and world state mutations deterministically without requiring an active render layer.

How do I connect Miniplex entity data to React Three Fiber views?

You connect Miniplex entity data to React Three Fiber views using the ModelContainer pattern. This connects entity data to dumb view components, keeping models reusable and testable across scenes while maintaining strict separation from game logic.

Why use a headless-first approach for React Three Fiber game development?

You use a headless-first approach for React Three Fiber game development to achieve deterministic system updates and decoupled world state. It allows clear separation between systems and views, enabling you to test game logic independently of the rendering layer.

Can I refactor an existing React Three Fiber project to use Miniplex ECS?

Yes, you can refactor an existing React Three Fiber project to use Miniplex ECS. The quick start involves moving all game logic into Systems while keeping React components as pure Views, applying scalable architecture patterns for clear data flow separation.