Magic Framework Guide

Magic is a Laravel-inspired Flutter framework.

Core Concepts

• MVC Architecture: Controllers handle logic, Models handle data, Views handle UI.
• Eloquent ORM: Models extend Model and use InteractsWithPersistence.
• Routing: Use Route facade in routes/app.dart and routes/auth.dart.
• Facades: Global access to services via Magic.instance or specific facades like Auth, Route, Log.
• Service Providers: Register services in config/app.dart.

Coding Standards

• Use snake_case for filenames, PascalCase for classes.
• Models should define table, resource, fillable.
• Controllers should return Widget or Future.
• Use MagicRoute for navigation.

Common Patterns

Model

class User extends Model with HasTimestamps, InteractsWithPersistence {
  @override String get table => 'users';
  @override String get resource => 'users';
  @override List get fillable => ['name', 'email'];
}

Controller

class UserController extends Controller {
  Future index() async {
    final users = await User.all();
    return view('users.index', {'users': users});
  }
}