fractal-tree-file-structure
Fractal tree file structure
This project follows a fractal tree approach to file organization, where the structure of any part mirrors the whole. This self-similar organization allows confident navigation without needing to understand the entire codebase.
Core principles
-
Recursive structure: Every directory follows the same organizational patterns, creating predictable navigation at any depth.
Developers should not need to learn the entire codebase structure to contribute meaningfully to any section. -
No circular dependencies: Imports must form a directed acyclic graph. Circular import chains turn the fractal tree into a generic graph, breaking the tree's integrity and causing runtime issues.
-
Organic growth: Start with a single file; extract to subdirectories only when complexity demands it. No boilerplate structure upfront. Group resources by functional purpose, never by file "shape" (no project-wide
components/,hooks/, orutils/folders).