CrudBot Documentation

Welcome to CrudBot - AI-powered CRUD builder for internal dashboards, business systems, and admin tools.

What CrudBot Is (and Isn't)

CrudBot is specifically designed for building internal business applications with CRUD operations, user management, and role-based access control.

✅ Crudbot Builds

✓ Admin dashboards
✓ Back-office systems
✓ Internal company tools
✓ CRUD + role-based access
✓ Reports & workflows
✓ Employee management systems
✓ Inventory tracking
✓ CRM and internal tools

❌ Crudbot Doesn't Build

✗ Marketing websites
✗ Portfolio or blog sites
✗ Frontend landing pages
✗ UI-heavy custom designs
✗ Public-facing stores
✗ Content management sites
✗ E-commerce storefronts
✗ Social media platforms

Getting Started

CrudBot is a web-based application builder that generates complete Laravel applications for internal business operations. Follow these steps to create your first project:

Click "Create New Project" from the dashboard
Use the AI Chatbot or Advanced mode to define your project
Define your database tables and relationships
Configure user roles and permissions
Generate and download your Laravel application

Generated Project Information

Default Login Credentials

Every generated Laravel application includes a default Super Admin account:

Email: super@admin.com

Password: Super@Admin

Role: Super Admin (full permissions)

⚠️ Important: Change these credentials immediately after first login for security!

Accessing Your Project

Your generated application is accessible at:

Development: https://preview.dev.crudbot.com/your-project-name/public
Production: https://preview.crudbot.com/your-project-name/public

Available Routes

Common routes in your generated application:

/login - User authentication
/register - New user registration
/dashboard - Main dashboard (requires login)
/profile - User profile management
/{table-name} - CRUD operations for each table
/{table-name}/create - Create new record
/{table-name}/{id}/edit - Edit existing record

Technology Stack

Generated projects include:

Laravel 12.x - Latest PHP Framework
Laravel Breeze - Authentication scaffolding
Spatie Laravel-Permission - Role & permission management
Bootstrap 5 - Frontend framework
Select2 - Enhanced dropdowns
DataTables - Advanced table features
Vite - Modern asset bundling

Using the AI Chatbot

Quick Create Mode

The AI Chatbot helps you build projects through conversation:

Describe your project idea in natural language
Answer the AI's questions about your requirements
Review the extracted project structure
Click "Apply & Continue" to create your database schema

Quick Actions

The AI provides contextual quick action buttons below each response. These suggestions help you:

Quickly respond with common answers
Proceed with AI recommendations
Navigate to next steps
Request more information

Chat & Preview Mode

For existing projects, click "Chat & Preview Mode" to see a split-view interface where you can chat with the AI while previewing your generated application in real-time.

Database Design

Defining Tables

Create database tables by specifying:

Table Name: Use singular form (e.g., "Product" not "Products")
Description: What data this table stores
Icon: FontAwesome icon for visual identification

Adding Fields

For each table, define fields with:

Field Name: Database column name
Display Name: Label shown in forms
Type: String, Integer, Boolean, Text, Date, DateTime, Decimal, Enum, File
Required: Whether field is mandatory
Nullable: Whether field can be empty in database
Validation: Laravel validation rules (e.g., "required|email|max:255")

Relationships

Connect tables through relationships:

Belongs To: Many-to-one (e.g., Product belongs to Category)
Has Many: One-to-many (e.g., Category has many Products)
Many to Many: Complex relationships with pivot tables

User Roles & Permissions

Defining Roles

Create user roles to control access:

Each role has a name and description
Assign permissions for each table (view, create, edit, delete)
Super Admin automatically gets all permissions

Permission System

Generated applications use Spatie Laravel-Permission:

Permissions are automatically created for each table
Users can have multiple roles
Middleware protects routes based on permissions
Authorization policies control access

Common Tasks

Reset Admin Password

php artisan tinker
$user = App\Models\User::where('email', 'super@admin.com')->first();
$user->password = Hash::make('YourNewPassword');
$user->save();

Add New Admin User

php artisan tinker
$user = App\Models\User::create([
    'name' => 'New Admin',
    'email' => 'admin@example.com',
    'password' => Hash::make('SecurePassword')
]);
$user->assignRole('Super Admin');

Clear Application Cache

php artisan cache:clear
php artisan config:clear
php artisan route:clear
php artisan view:clear

FAQs

What is CrudBot?

CrudBot is an AI-powered CRUD builder specifically designed for internal dashboards, business systems, and admin tools. It generates complete Laravel applications with role-based access control, perfect for back-office operations and internal company workflows.

What kind of applications can I build?

CrudBot excels at building internal business applications such as:

Employee management systems and HR dashboards
Inventory tracking and asset management tools
CRM systems for sales teams
Internal ticketing and support systems
Project and task management dashboards
Business reporting and analytics tools
Back-office data management systems

Do I need coding experience?

Basic understanding of databases is helpful, but you don't need to be a programmer. CrudBot handles all the code generation and provides an intuitive interface.

Can I customize the generated code?

Yes! The generated Laravel code is fully customizable. You receive complete source code that follows Laravel best practices and can be modified as needed.

What databases are supported?

Generated applications use MySQL/MariaDB by default. The code can be adapted for other databases supported by Laravel (PostgreSQL, SQLite, SQL Server).

How do file uploads work?

If your project includes file upload fields:

Files are stored in storage/app/public/
Public access is provided via symbolic link
File validation is handled automatically
Multiple file formats supported

Can I deploy to production?

Yes! Generated applications are production-ready and include:

Security features (CSRF protection, authentication)
Database migrations and seeders
Proper file permissions
Environment configuration

Support

Getting Help

Documentation: This page contains all essential information
AI Assistant: Use the chatbot for project-specific questions
Contact: Reach out through our contact page for support

Learning Resources

CrudBot Resources

Product Roadmap - See what features are coming next
Pricing Plans - Choose the right plan for your needs
Home Page - Learn more about CrudBot's focus on internal tools