How ethanvibe/excelcut works
ExPierceViz is a desktop Excel-data composition and visualization tool. Users upload spreadsheets, select and combine fields, configure calculations and aggregations, inspect composed data, switch to charting, then export the table or chart. The architecture separates file parsing, composition, shared application state, and visualization/export UI. The README documents broader product capabilities; sampled excerpts confirm the primary composition and chart paths, but not every implementation detail. Electron is represented as the documented desktop host; its source was not excerpted.
Main entry points: App.tsx App shell · AppContext.tsx Application state · FilePanel.tsx File panel · VizPage.tsx Charting and export
Components 15
Application shell
- Electron host
electron/main.cjs - React entry
src/main.tsx - App shell
src/App.tsx
Data preparation
- File panel
src/components/FilePanel.tsx - Excel parser
src/lib/excel.ts - Data workspace
src/components/DataWorkspace.tsx - Data composition
src/lib/excel.ts - Field configuration
src/components/ConfigPanel.tsx
Visualization and export
- Navigation and export
src/components/TopNav.tsx - Charting and export
src/components/VizPage.tsx
Shared UI and state
- Application state
src/store/AppContext.tsx - Notifications
src/components/Toast.tsx - Footer
src/components/Footer.tsx - Button control
src/components/ui/button.tsx
Other components
- User
Connections 27
- User → Electron host: launches
- Electron host → React entry: hosts
- React entry → App shell: renders
src/main.tsx - App shell → File panel: renders
src/App.tsx - App shell → Data workspace: renders
src/App.tsx - App shell → Field configuration: renders
src/App.tsx - App shell → Charting and export: renders
src/App.tsx - App shell → Navigation and export: renders
src/App.tsx - App shell → Footer: renders
src/App.tsx - App shell → Application state: provides state
src/App.tsx - App shell → Notifications: provides notifications
src/App.tsx - File panel → Excel parser: parses files
src/components/FilePanel.tsx - File panel → Application state: updates files
src/components/FilePanel.tsx - Data workspace → Data composition: composes data
src/components/DataWorkspace.tsx - Data workspace → Application state: reads and updates
src/components/DataWorkspace.tsx - Field configuration → Application state: updates settings
src/components/ConfigPanel.tsx - Navigation and export → Application state: reads state
src/components/TopNav.tsx - Charting and export → Application state: reads chart data
src/components/VizPage.tsx - File panel → Notifications: reports status
src/components/FilePanel.tsx - Field configuration → Notifications: reports status
src/components/ConfigPanel.tsx - Charting and export → Notifications: reports export status
src/components/VizPage.tsx - Navigation and export → Button control: uses controls
src/components/TopNav.tsx - Charting and export → Button control: uses controls
src/components/VizPage.tsx - User → File panel: uploads spreadsheets
src/components/FilePanel.tsx - User → Data workspace: selects fields
src/components/DataWorkspace.tsx - User → Charting and export: configures charts
src/components/VizPage.tsx - User → Navigation and export: exports table
src/components/TopNav.tsx