A world-class business analytics dashboard with advanced data management, multi-format import/export, and enterprise-grade visualizations.
🚀 Live Demo • 📚 Documentation • 🌐 Official Website • 📖 Website Files • 🎬 Video Demo • 💬 Discord
- 🌟 What's New in v1.3.3
- ✨ Features
- 🚀 Quick Start
- 📚 Documentation
- 🧪 Testing
- 🤝 Contributing
- 📞 Support & Community
Major Update: Multi-selection functionality, professional UI modals, and critical bug fixes!
Key Highlights:
- ✅ Multi-Selection System - Bulk operations with checkboxes and "Select All" functionality
- 🎨 Professional UI Modals - Custom confirmation dialogs replacing browser alerts
- 🧪 Enhanced Testing Suite - 25+ comprehensive tests with visual test runner
- 🪲 Critical Bug Fixes - Resolved duplicate ID issues and selection state problems
📋 View Complete Release Notes | 📜 Version History
- 8 Data Summary Cards - Total revenue, expenses, profit, customers with growth indicators
- Trend Sparklines - 6-month trend visualization for all key metrics
- Interactive Pie Charts - Expense categories and revenue source breakdowns
- Performance Scoring - Business health score with industry benchmarks
- Advanced Calculations - Profit margins, CLV, CAC, churn rates, burn rate
- Date Range Analytics - Flexible filtering with preset options
- Forecasting - Revenue, expense, and customer growth projections
- Multi-Format Import - JSON, CSV, Excel with intelligent field mapping
- Multi-Format Export - JSON, CSV, Excel with metadata and summaries
- Data Validation - Comprehensive validation with error reporting
- Import Preview - Review data before importing with merge options
- Auto-Backup System - Automatic backups on every data change
- Manual Backups - Create restore points before major operations
- Template Downloads - Pre-formatted templates for easy data entry
- Complete CRM - Full customer lifecycle management
- Customer Analytics - Value distribution, acquisition tracking, status management
- Lifetime Value (CLV) - Automatic CLV calculation and tracking
- Customer Segmentation - Active, potential, inactive customer analysis
- Acquisition Tracking - Customer acquisition cost (CAC) monitoring
- Contact Management - Email, phone, company details with search
- Revenue Analytics - Multi-source revenue tracking with categorization
- Expense Management - Vendor tracking, receipt management, category analysis
- Cash Flow Analysis - Monthly cash flow tracking and projections
- Profit Analysis - Real-time profit calculations with margin tracking
- Burn Rate Monitoring - Business runway calculations
- Transaction History - Detailed financial records with full audit trail
- Professional Design - Modern, clean interface with brand consistency
- Responsive Excellence - Perfect experience on all devices
- Smart Empty States - Helpful guidance when no data exists
- Interactive Elements - Hover effects, tooltips, and smooth transitions
- Loading States - Professional loading indicators throughout
- Error Recovery - Comprehensive error handling with user guidance
- Node.js (v18.0.0 or higher recommended)
- npm or yarn package manager
- Modern web browser (Chrome, Firefox, Safari, Edge)
-
Clone the repository
git clone https://github.com/kenthic/biz-grow.git cd biz-grow -
Install dependencies
npm install # or yarn install -
Start the development server
npm run dev # or yarn dev -
Open your browser and start using BizGrow
http://localhost:5173
npm run build
# or
yarn buildThe built files will be in the dist/ directory, ready for deployment.
For comprehensive documentation, guides, and tutorials, visit our 📚 GitHub Wiki.
- 📥 Installation Guide - Complete setup instructions
- ⚡ Quick Start - Get running in 5 minutes
- ✅ Multi-Selection System - New v1.3.3 feature guide
- 🧪 Testing Guide - Comprehensive testing documentation
- 🔧 API Reference - Technical documentation
- 🐛 Troubleshooting - Common issues and solutions
BizGrow includes a comprehensive testing framework with 25+ automated tests:
- Dashboard Access - Click "Test Suite" button on Dashboard
- Test Selection - Choose from All Tests, Quick Test, Multi-Selection, etc.
- Run Tests - Execute tests with real-time results
- Keyboard Shortcut - Use
Ctrl+Shift+Tto toggle test runner
// Run in browser console (F12)
window.BizGrowTestSuite.runAllTests() // Full test suite
window.BizGrowTestSuite.quickTest() // Essential tests
window.BizGrowTestSuite.testMultiSelection() // v1.3.3 features
window.BizGrowTestSuite.debugState() // Debug info- Multi-Selection System - Bulk operations and checkbox functionality
- Professional UI Modals - Custom confirmation dialogs
- ID Management - Data integrity and uniqueness
- Performance Testing - Memory usage and large dataset handling
- Version Synchronization - Automatic version management
📚 For detailed testing documentation, see Testing Guide
Create a .env file in the root directory:
# Application Configuration
VITE_APP_NAME=BizGrow Dashboard
VITE_APP_VERSION=1.3.3
# Development Configuration
NODE_ENV=development
# Future API Configuration
# VITE_API_BASE_URL=http://localhost:3001/api:root {
--primary-color: #3498DB; /* Medium Blue */
--primary-dark: #1B4F72; /* Navy Blue */
--primary-light: #5DADE2; /* Light Blue */
--secondary-color: #2E86AB; /* Dark Blue */
}// tailwind.config.js
module.exports = {
theme: {
extend: {
colors: {
'bizgrow-blue': '#3498DB',
'bizgrow-navy': '#1B4F72',
'bizgrow-light': '#5DADE2',
'bizgrow-dark': '#2E86AB',
},
},
},
}npm run build
npm run preview # Test production build locally- Netlify - Drag and drop the
dist/folder - Vercel - Connect your GitHub repository
- GitHub Pages - Use the
docs/folder for static site - Traditional Hosting - Upload
dist/contents to web server
The docs/ folder contains a complete website (separate from documentation):
- Professional landing page hosted on GitHub Pages
- Feature showcase and screenshots
- Live demo links and promotional content
- Contact information and getting started guide
Note: For comprehensive documentation, use the GitHub Wiki.
We welcome contributions! Here's how to get involved:
- 🐛 Report Bugs - Open issues for any problems you find
- ✨ Request Features - Suggest new functionality
- 📝 Improve Documentation - Help make docs clearer
- 🧪 Add Tests - Expand test coverage
- 💻 Submit Code - Fix bugs or add features
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Make your changes and test thoroughly
- Run the test suite to ensure everything works
- Commit your changes:
git commit -m 'Add amazing feature' - Push to your branch:
git push origin feature/amazing-feature - Open a Pull Request
- Follow existing code style and patterns
- Add comprehensive tests for new features
- Update documentation for any changes
- Ensure responsive design for all UI changes
- Provide clear description of changes
- Include screenshots for UI changes
- Reference related issues
- Ensure all tests pass
This project is licensed under the MIT License - see the LICENSE file for details.
- React Team - For the incredible framework that powers BizGrow
- Tailwind CSS - For the utility-first CSS framework
- Recharts - For beautiful and responsive chart components
- Framer Motion - For smooth animations and transitions
- Lucide - For the comprehensive icon library
- SheetJS - For Excel file processing capabilities
- Early Testers - Thank you for your valuable feedback
- Contributors - Every contribution makes BizGrow better
- Open Source Community - For the amazing tools and libraries
- 📧 Email Support: bizgrowapp@gmail.com
- 💬 Discord Community: Join our server
- 🐛 Bug Reports: GitHub Issues
- ✨ Feature Requests: GitHub Discussions
- 📚 Complete Documentation: GitHub Wiki
- 🎬 Video Tutorials: YouTube Channel
- 🔧 API Reference: Developer Documentation
- 📖 Official Website: Project Website
- ⭐ Star this repo to stay updated with new releases
- 👀 Watch releases to get notified of new versions
- 🐦 Follow updates on our social channels
