Architecture: How should platform builder libraries be organized to separa...

Documentation for Sessions

🏗️ Architecture: How should platform builder libraries be organized to separa...

📋 Decision Context

Question:

How should platform builder libraries be organized to separate Space vs Universe level components?

Task: Library reorganization into Space vs Universe hierarchy (Session 28.2)


🎯 Decision Made

Chosen:

Create libs-universe with re-exports (non-breaking)

Options Considered:

  1. Move all files to new folders (breaking changes)
  2. Create libs-universe with re-exports (non-breaking)
  3. Keep everything in libs-structural
  4. Merge libs-space and libs-structural

💭 Reasoning

Created libs-universe as a new NX library that re-exports universe-level components from their current locations (libs-space/universe-* and libs-structural/*). This non-breaking approach: 1) Provides clear semantic separation between Space (global/company) and Universe (project) level components, 2) Follows SCSS-like inheritance where Space settings cascade down and Universe settings take precedence, 3) Maintains backward compatibility since original imports still work, 4) Allows gradual migration to the new @libs-universe import path. The hierarchy now mirrors the actual platform building experience: Space → Universe.


📁 Files Involved


🔗 Related


Auto-generated by MCP Smart Consolidation