Loading...
BEH App Starter Kit - Build Fast Flutter Template
⏱️ Time saved: 200+ hours (even more with AI assistance!)
A premium Flutter starter kit implementing MVVM architecture with Riverpod state management and Supabase backend. This template provides a solid foundation for developing your own business management solution with features like sales tracking, customer management, and PDF invoice generator.
💰 One-time purchase: $39 USD
Buy Now & Start Building!
Get instant access to the BEH App Starter Kit by purchasing through Buy Me a Coffee and don’t forget to use the coupon code for discount price! 😎
Buy on Buy Me a Coffee Shop PageAfter purchase, you'll receive immediate download access to a ZIP file.
📦 What's Included in Your Purchase:
💻 Source Code & Project Files
- ✅ Complete Flutter project implementing MVVM architecture
- ✅ Riverpod state management with code generator
- ✅ Supabase backend integration for authentication
- ✅ Pre-configured
flutter_screenutil,gap,go_router,shorebird_code_pushand more - ✅ Custom theme with light/dark mode support
🗃️ Database Resources
- ✅ Ready-to-import SQL schema files:
roles.sql- Database role definitionsschema.sql- Complete table structure and relationships
🧩 Feature Modules
- ✅ Sales Management system with detailed tracking
- ✅ Purchase Recording with product breakdowns
- ✅ Customer Database with balances and history
- ✅ PDF Invoice Generator with Bangla text support
- ✅ Multi-language Support (English & Bangla)
🎓 Learning Resources
- ✅ Video tutorials for setup and configuration
- ✅ Comprehensive README with step-by-step guides
💯 Why Choose This Kit?
Save weeks of development time with a production-ready foundation built following best practices. Perfect for developers looking to quickly launch professional business management apps.
⏱️ Time Savings Breakdown:
- Architecture Setup: 40-60 hours saved
- UI Components & Theming: 30-40 hours saved
- Authentication System: 20-30 hours saved
- Feature Implementation: 80-100 hours saved
- Database Schema: 20-30 hours saved
- Testing & Debugging: 30-40 hours saved
- Total: 200+ hours (4-6 weeks) of development time saved!
- With AI Assistance: Reduce remaining customization time by up to 70%
1. Acknowledge
This project was inspired by the Flutter App Architecture Guide, the Starter Architecture for Flutter & Firebase, and the Flutter MVVM Riverpod Starter
2. Architecture Overview
This starter kit follows the Model-View-ViewModel (MVVM) architecture pattern:
- Model: Represents the data and business logic of the application
- View: UI components that display data and send user actions to the ViewModel
- ViewModel: Manages UI state and connects the View with the Model
2.1. Key architectural principles:
- Separation of Concerns: Each layer has a specific responsibility
- Testability: Business logic is separated from UI for easier testing
- Maintainability: Modular architecture makes code easier to maintain
- Reusability: Components can be reused across different parts of the app
3. Tech Stack
- Framework: Flutter for cross-platform mobile development
- State Management: Riverpod with code generator
- Architecture: MVVM (Model-View-ViewModel)
- Backend: Supabase for database, authentication, and real-time updates
- PDF Generator: Flutter PDF library with Bangla text support
- Language Support: Easy Localization for multiple languages
- Routing: Go Router for declarative routing
- UI Components: Custom responsive widgets with Flutter ScreenUtil
4. Core Dependencies
flutter_riverpod&riverpod_annotation: Reactive state managementsupabase_flutter: Backend services, auth, and real-time databasepdf: PDF document generatorbijoy_helper: Bangla text support for PDF generatoreasy_localization: Internationalization and multiple language supportgo_router: Navigation and routingflutter_screenutil: Responsive UI scalingenvied: Secure environment variable managementfreezed: Immutable state modelsintl: Date formatting and localizationshare_plus: Sharing PDFs and reports
5. Project Structure
bash
6. Code Organization
Each feature module follows this structure:
bash
This structure follows the MVVM pattern where:
- Models (M): Defined in the
model/directory - Views (V): Implemented in UI screens and widgets
- ViewModels (VM): Located in the
ui/view_models/directory to connect models with views
7. Getting Started
7.1. Prerequisites
- Flutter SDK 3.29.2 or higher
- Docker Desktop (for Supabase database restoration)
- PostgreSQL and psql (for database operations)
- Supabase CLI
- Git (for version control)
- Android Studio or VS Code with Flutter extensions
7.2. Supabase Setup
First, set up your Supabase environment following the official guide from Supabase Backup and Restore:
-
Create a new Supabase project at supabase.com
-
Install the Supabase CLI:
bash -
Install Docker Desktop for your platform from docker.com or https://docs.docker.com/desktop/
-
Get the new database connection string from your Supabase project:
- Go to your project dashboard
- Click on "Project Settings" > "Database"
- Click the "Connection string" button and select "URI"
- Copy the connection string (will look like
postgresql://postgres.[PROJECT-REF]:[YOUR-PASSWORD]@aws-0-us-east-1.pooler.supabase.com:5432/postgres) - Replace
[YOUR-PASSWORD]with your database password
-
Restore the database using the provided SQL files:
bash -
Disable email confirmation in Supabase:
- Log in to your Supabase dashboard at supabase.com
- Navigate to "Authentication" in the left sidebar
- Select "Providers" tab
- Find "Email" provider and click on it
- Turn OFF the "Confirm email" toggle
- Save your changes
- This allows users to sign up without requiring email verification
7.3. App Setup and Configuration
-
Download and extract the starter kit from your Buy Me A Coffee purchase email
- Once extracted, you'll find three main directories:
- behask/: The complete Flutter project with source code and assets
- database/: SQL files (
roles.sqlandschema.sql) for Supabase setup - videos/: Setup tutorials and guidance for configuration
- Once extracted, you'll find three main directories:
-
Install dependencies
bash -
Modify environment files for Supabase configuration
bash -
Generate necessary code
bash -
Change the app information
- To change the app package name, run the following command:
bash- To change the Android app name, open the
android/app/src/main/AndroidManifest.xmlfile, change theandroid:label="Your App Name" - To change the iOS app name, open the
ios/Runner/Info.plistfile, change theCFBundleDisplayNametoYour App Name - To change the iOS bundle name, open the
ios/Runner/Info.plistfile, change theCFBundleNametoyour_bundle_name
-
Update your app icons
- The project is already set up with the
flutter_launcher_iconspackage - Replace the image at
assets/images/logo_fill.pngwith your own logo (recommended size 1024x1024px) - Run the following command to generate icons for both Android and iOS:
bash - The project is already set up with the
-
Run the app
bash
7.4. Managing Database Changes with pgAdmin
For database management and schema changes, you can use pgAdmin as described in the Supabase pgAdmin guide:
-
Download and install pgAdmin from pgadmin.org
-
Register a new Postgres server:
- Right-click on "Servers" in the pgAdmin browser and select "Register" > "Server..."
- In the "General" tab, name your server (e.g., "BEH Supabase")
- In the "Connection" tab:
- Enter the Host name/address from your Supabase connection string
- Enter "5432" as the port
- Enter "postgres" as the maintenance database
- Enter "postgres" as the username
- Enter your database password
- In the "SSL" tab:
- Set "SSL mode" to "Require"
- Download your SSL certificate from the Supabase Dashboard's Database Settings
- Set the "Root certificate" field to the path of the downloaded certificate
-
For comparing and synchronizing schema changes between development and production:
- Right-click on your database in pgAdmin
- Select "Compare" > "Schema Comparison"
- Select your source and target databases
- Select the schemas to compare
- Click "Compare" to see the differences
- Click "Generate Script" to create a SQL script of the changes
- Review and run the script on your target database
8. Deployment Guide
8.1. Code Generation and Cleanup
Before building for production, clean up generated files and regenerate them:
8.1.1. For Windows (PowerShell)
bash
8.1.2. For Mac/Linux (Bash/Shell)
bash
8.2. Building Optimized APK
For the smallest possible APK:
bash
8.3. Using Shorebird for Updates (Optional)
This project is configured for Shorebird, which enables over-the-air code updates:
-
Install Shorebird CLI and authenticate
-
Configure your
shorebird.yamlfile with your app details:yaml -
Release a new version:
bash -
Deploy a patch update:
bash
For more detailed instructions on using Shorebird, refer to the official documentation.
8.4. Android App Signing
This project uses Kotlin DSL for Gradle build files (build.gradle.kts). To enable app signing for your release builds:
-
Create a keystore file using the following command:
bash -
Create a
key.propertiesfile in theandroid/directory with the following content:properties -
Configure signing in
android/app/build.gradle.kts:kotlin
For more detailed information on Android app signing, refer to the Flutter Android deployment documentation.
9. Customization Guide
9.1. Branding
- Update app name in
pubspec.yaml - Replace logo and splash images in
assets/images/ - Modify theme colors in
lib/theme/
9.2. Features
- Each feature is modular and located in the
lib/features/directory - Extend or modify features based on your business requirements
- Add new features by following the existing MVVM pattern
10. Screenshots
| Light Theme | Dark Theme |
|---|---|
11. Why Choose This Starter Kit?
- Save Development Time: Skip weeks of setup and architecture decisions
- Production-Ready Code: Follow best practices with clean architecture
- Easy Customization: Modular design makes it easy to adapt to your needs
- Performance Optimized: Built with performance in mind from the start
- Regular Updates: Purchase includes access to future updates and improvements
12. License
This starter kit is licensed under a Commercial License that restricts usage to one commercial project per purchase. The license includes:
- Permission to use for a single commercial project
- Rights to modify the code for your specific project
- Restrictions on redistribution and reselling
See the LICENSE file for complete terms and conditions.
13. Support
After purchase, you'll receive:
- Full source code access
- Database schema scripts
- Documentation and setup guide
- 30 days of email support
For questions or support, contact: biplobsd11@gmail.com
14. What's Included in Your Purchase
When you purchase the BEH App Starter Kit, you'll receive a ZIP file containing:
14.1. Source Code and Assets
- Complete Flutter project with all source code
- Pre-configured Android and iOS configurations
- Asset files including images, icons, and animations
- Theme configuration files
14.2. Database Files
- SQL schema files (located in the
databasedirectory):roles.sql: Database role definitionsschema.sql: Complete database structure with tables and relationships
14.3. Video Tutorials
- Setup screencasts in the
videodirectory - Database configuration tutorials
- User interface walkthrough video
14.4. Support Resources
- Access to future updates and improvements
- Troubleshooting guides
15. Video Setup Instructions
For detailed visual guidance on setting up and using this starter kit, please refer to the video screenrecords in the video folder. These recordings provide step-by-step instructions on:
- Supabase configuration and database setup
- Flutter project configuration
- Environment setup and API key integration
- Running the application for the first time
Watch these instructional video for a comprehensive visual guide to get your application up and running quickly.
16. Getting Started for Non-Technical Users
If you're new to app development, this section will help you understand what you need to get started with this kit.
16.1. What You Need to Learn
-
Basic Flutter Concepts: Understanding how Flutter works, including widgets and basic UI building
- Resource: Flutter Getting Started Guide
- Time investment: 2-3 weeks of part-time learning
-
Riverpod Basics: Learning the state management system used in this app
- Resource: Riverpod Documentation
- Time investment: 1 week
-
Supabase Fundamentals: Understanding how to work with the backend
- Resource: Supabase Quickstart
- Time investment: 1 week
16.2. Tools You'll Need
-
Flutter SDK: The software development kit for building the app
- Download from: flutter.dev
-
Visual Studio Code or Android Studio: Code editor to work on the app
- VS Code: code.visualstudio.com
- Android Studio: developer.android.com/studio
-
Git: For version control and managing code changes
- Download from: git-scm.com
-
Supabase Account: For backend services like database and authentication
- Sign up at: supabase.com
16.3. Leveraging AI-Powered Code Editors
As a non-technical person, modern AI-powered code editors can dramatically accelerate your learning journey and development capabilities:
- Cursor AI Code Editor: These AI-powered code editors can:
- Help you understand the codebase through intelligent explanations
- Generate code snippets based on your natural language descriptions
- Fix errors automatically when you encounter issues
- Provide real-time guidance as you modify the app
- Download from: cursor.sh
By combining this starter kit with an AI code editor, you can:
- Reduce the Learning Curve: Get explanations of complex code patterns in simple terms
- Accelerate Development: Complete in days what might take weeks for a beginner
- Experience "Vibe Coding": Enjoy a more intuitive, conversation-based coding experience
- Gain Confidence: Make changes with the safety net of AI assistance
- Learn Faster: Understand best practices through AI explanations rather than trial and error
This combination creates a powerful environment where even non-technical users can successfully modify and extend the application with minimal frustration.
16.4. Simple Steps to Begin
- Learn the basics: Spend time with the learning resources mentioned above
- Set up your development environment: Install Flutter and a code editor
- Watch the setup videos: In the
videosfolder for visual guidance - Follow the setup instructions: In the "Getting Started After Purchase" section
- Experiment with small changes: Start by making minor UI modifications
- Join Flutter communities: For help when you get stuck (Flutter Discord, Stack Overflow)
Remember, app development is a learning journey. Start with small changes, gradually increase complexity, and don't hesitate to use the provided example code as a reference.
17. What You'll Learn from This Project
By studying and working with this starter kit, you'll gain valuable experience and knowledge in:
-
Production-Grade Flutter Architecture: Understand how to structure large Flutter applications using MVVM architecture with clear separation of concerns.
-
Advanced State Management: Master Riverpod's powerful state management techniques including providers, state notifiers, and code generator.
-
Backend Integration Best Practices: Learn how to properly connect Flutter apps to Supabase backend services, including authentication, database operations, and real-time updates.
-
PDF Generator and Document Processing: Explore techniques for creating professional documents directly from your app, with support for complex text including Bangla characters.
-
Proper Error Handling: See examples of robust error handling patterns that improve app stability and user experience.
-
Multi-Language Support: Understand internationalization implementation for supporting multiple languages in your app.
-
Theme Management: Learn techniques for implementing and switching between light and dark themes while maintaining a consistent design language.
-
Responsive UI Design: Gain insights into building interfaces that work across different screen sizes and orientations.
-
Data Modeling Techniques: See how to create efficient, type-safe data models with Freezed for serialization and immutability.
-
Professional App Organization: Experience a well-structured project that follows industry best practices for maintainability and scalability.
These skills are highly transferable to other Flutter projects and will significantly improve your capabilities as a mobile app developer, regardless of your starting point.
18. Developed By
SpeedOut Source - A digital product studio specializing in Flutter development and business solutions.
© 2025 SpeedOut Source | All rights reserved