Component Resource Map
This is the master registry of all components in the plugzero-analytics repository. Use this list to check for existing UI patterns before building new ones.
🧱 Atomic Components (src/components/ui)
These are foundational primitives built using Radix UI and Tailwind CSS.
| Component | Purpose |
|---|---|
button.tsx | Primary triggers with loading and variant support. |
dialog.tsx | Modal windows for creations (e.g., Create Project). |
table.tsx | Clean, accessible data tables using TanStack logic. |
select.tsx | Optimized dropdowns for variable selection. |
tabs.tsx | Used for switching between analysis views. |
sheet.tsx | Slide-out panels for settings and filters. |
sonner.tsx | Modern toast notifications for system alerts. |
dropdown-menu.tsx | Contextual actions for data records. |
card.tsx | The standard container for dashboard widgets. |
form.tsx | Zod-validated forms with built-in error handling. |
🔬 Analytics & Analysis (src/components/analytics)
Components responsible for calculating and visualizing intelligence.
| Component | Responsibility |
|---|---|
AnalysisBuilder | Manages variable mapping for the math engines. |
DashboardBuilder | Allows users to arrange visualizations in a grid. |
VisualizationRenderer | The polymorphic entry point for all charts. |
AIChat | The interface for interacting with the AI Agent. |
ReportBuilder | The workspace for creating multi-page narratives. |
HighlightableReport | Enables the anchored commenting system. |
ChartCard | A specialized card that handles its own “Download” logic. |
SimpleBarChart | Recharts wrapper for frequency and segmentation. |
SimplePieChart | Best for showing market share or gender splits. |
SimpleRadarChart | Used for competitor benchmarking. |
📋 Survey Engine (src/components/surveys)
Tools for building, managing, and taking research surveys.
| Component | Responsibility |
|---|---|
SurveyBuilder | The visual drag-and-drop workspace for survey design. |
LogicBranchBuilder | Interactive editor for “skip-logic” rules. |
FocusSurveyRenderer | The respondent’s UI (optimized for 60fps). |
PublicSurveyViewer | The public URL entry point for surveys. |
SurveyManager | The list view for tracking respondent volume. |
SurveyResponses | A high-performance viewer for raw survey data. |
InterceptsDashboard | Settings for on-site website pop-up surveys. |
📂 Data Collection & Management (src/components/data-collection)
Components for ingestion, scraping, and project organization.
| Component | Responsibility |
|---|---|
RawFileUploadForm | Multi-file uploader with real-time validation. |
WebScraper | The UI for the automated web data crawler. |
DataFileManager | The library of uploaded files per project. |
FileViewer | Browser-based spreadsheet viewer for CSV/Excel. |
ProjectsList | The entry point for selecting research workspaces. |
CampaignWorkflowEditor | Visual designer for multi-stage research missions. |
CommunitiesList | Management of panelist groups and smart lists. |
⚙️ Administration (src/components/account, teams)
| Component | Responsibility |
|---|---|
TeamManager | Interface for roles and seat management. |
TwoFactorSetup | TOTP authentication setup and QR generator. |
InviteMemberDialog | The secure email invitation workflow. |
BillingSummary | Integration with Stripe for plan management. |
Last updated on