Transform your Microsoft Fabric tenant into an interactive 3D universe - Visualize workspaces, track lineage across 23 artifact types, and govern your data estate with unprecedented clarity.
🎯 Features • 🚀 Quick Start • 📖 Documentation • 🤝 Contributing
- 23 Artifact Types - From Lakehouses to ML Models, Notebooks to Eventstreams
- Domain-Based Clustering - Visualize organizational structure with Microsoft Fabric domains
- Real-Time Lineage - Track data flow across Semantic Models, Dataflows, Lakehouses, and Reports
- Cross-Workspace Dependencies - See how artifacts connect across your entire tenant
- Interactive 3D Graph - Powered by Three.js and 3d-force-graph
- Smart Clustering - Automatic spatial organization by domains and workspaces
- Focus Mode - Isolate specific workspaces or domains for detailed analysis
- Search & Highlight - Type to dim non-matching nodes, instantly find artifacts
- Side Panel - Click any node for full metadata, upstream/downstream lineage
- Legend Panel - Dynamic color reference for all artifact types in view
- Fog Effects - Depth perception for complex tenants with thousands of objects
- Official Microsoft Badges - Certified and Promoted endorsement visualization
- Endorsement Dashboard - Coverage stats with per-domain breakdown (Certified/Promoted/None)
- Sensitivity Labels - Confidential, Highly Confidential, Internal, Public classification
- Compliance View - Instantly spot unlabeled artifacts across your tenant
- Impact Analysis - BFS downstream tracing: "what breaks if I change this?"
- Domain Management - Assign unassigned workspaces with smart domain suggestions
- Batch Operations - Manage multiple workspace assignments efficiently
- Scanner API Integration - Direct tenant scanning with Microsoft Fabric Admin API
- Fabric REST API - Domains API + Items API for Notebooks, Pipelines, Eventstreams
- JSON File Import - Load pre-scanned data for offline analysis
- Mock Data Support - Demo mode with 50+ sample workspaces for testing
- Microsoft Fabric Admin Access - Tenant-level permissions required
- Node.js 16+ and npm 8+
- Modern Browser - Chrome, Edge, or Firefox (WebGL support required)
# Clone the repository
git clone https://github.com/Fabric-Lineage/FabricBEyeAI.git
cd FabricBEyeAI
# Install dependencies
npm install
# Start development server
npm startNavigate to http://localhost:4200 - The app will automatically reload on file changes.
- Login - Click the login button and authenticate with your Microsoft Fabric credentials
- Scan - Initiate a workspace scan or import a JSON file
- Explore - Navigate the 3D visualization with mouse/trackpad
- Analyze - Use filters, focus mode, and domain clustering to understand your data estate
|
|
| Action | Control |
|---|---|
| Rotate View | Left Mouse Drag |
| Pan View | Right Mouse Drag |
| Zoom | Mouse Wheel |
| Select Node | Click |
| Multi-Select | Ctrl + Click |
Isolate specific workspaces or domains to reduce visual complexity:
- Click domain name to focus on that domain
- Click workspace to focus on workspace artifacts
- Press ESC or click "Show All" to reset
- Smart Search - Type to highlight matching nodes; non-matches dim to 8% opacity
- Type Filters - Show/hide specific artifact types
- Fog Toggle - Enable depth fog for large tenants
- Unassigned Toggle - Hide/show workspaces without domains
Click any node to open the side panel with:
- Full metadata (endorsement, sensitivity label, description)
- Upstream and downstream dependencies
- Impact Analysis button — traces ALL downstream dependents
- Trust Dashboard - Endorsement coverage bar chart with per-domain breakdown
- Compliance View - Highlight unlabeled artifacts, badge shows gap count
Assign workspaces to domains with smart suggestions:
- Open Domain Assignment panel
- Select unassigned workspaces
- Choose target domain from suggestions
- Click "Assign Selected" to apply
- Screenshot - Export PNG image of current view
- JSON Export - Save complete graph data for offline analysis
| Category | Technologies |
|---|---|
| Frontend | Angular 17, TypeScript 5.2 |
| 3D Rendering | Three.js, 3d-force-graph v1.73 |
| UI Framework | Angular Material |
| State Management | RxJS Observables |
| Build System | Angular CLI, Webpack |
| API Integration | Microsoft Fabric Admin Scanner API v1.0, Fabric REST API (Domains, Items) |
- Developer Guide - Architecture, data flow, and code structure
- Supported Artifacts - Complete artifact type reference
- Contributing Guide - How to contribute to the project
- Refactoring Summary - Recent code improvements
- Migration Plan - Fabric evolution roadmap
We welcome contributions from the community! Here's how you can help:
- Fork the repository
- Create a feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'feat: Add AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
See CONTRIBUTING.md for detailed guidelines.
npm start # Start dev server (localhost:4200)
npm run build # Production build
npm run docs # Build for GitHub Pages
npm test # Run unit tests
npm run lint # Run ESLint
npm run e2e # Run end-to-end testsModern data platforms are complex, interconnected ecosystems. Understanding:
- How data flows across your tenant
- Which workspaces depend on which datasets
- What artifacts are certified vs. uncertified
- How to organize and govern at scale
...is nearly impossible with flat lists and tables.
FabricBEyeAI transforms complexity into clarity through:
- 3D Spatial Organization - Natural clustering by domains and workspaces
- Visual Lineage - See connections at a glance, not buried in metadata
- Interactive Exploration - Navigate, filter, and focus on what matters
- Governance Integration - Endorsements, labels, and domain management
This project is licensed under the MIT License - see the LICENSE file for details.
- Original Creator - Assaf Shemesh (@assafsun)
- Microsoft Fabric Team - For the comprehensive Admin Scanner API
- Open Source Libraries - Three.js, Angular, 3d-force-graph contributors
- Community Contributors - Everyone who has submitted issues, PRs, and feedback
- Live Demo: Fabric-Lineage.github.io/FabricBEyeAI
- GitHub Issues: Report Bugs
- Discussions: Ask Questions
⭐ Star this repo if you find FabricBEyeAI useful!
Made with ❤️ by the Fabric Lineage Community