newznab-tmux/BLADE_MIGRATION_README.md

Blade + TailwindCSS Migration - Quick Start

Migration Status

✅ Completed:

• BasePageController updated to use Blade views
• Main and Admin layouts created with TailwindCSS
• Blade partials created (header, sidebar, footer, admin menu)
• BrowseController migrated to Blade
• DetailsController migrated to Blade
• Browse, Details, Search, and Admin Dashboard views created
• Migration helper script created

⏳ Remaining Work:

• Migrate remaining 40+ controllers
• Convert 100+ Smarty templates to Blade
• Update all AJAX endpoints
• Test thoroughly

Quick Start

1. Install Dependencies (if needed)

npm install

2. Compile Assets

npm run build
# or for development with hot reload:
npm run dev

3. Clear Caches

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

4. Test the Migrated Pages

Visit these URLs to see the new Blade templates in action:

• Browse: /browse/All
• Details: /details/{guid}
• Admin Dashboard: /admin
• Search: /search

File Structure

resources/views/
├── layouts/
│   ├── main.blade.php          # Main user-facing layout
│   ├── admin.blade.php         # Admin panel layout
│   └── app.blade.php           # Auth layout (existing)
├── partials/
│   ├── header-menu.blade.php   # Top navigation
│   ├── sidebar.blade.php       # Left sidebar
│   ├── footer.blade.php        # Footer
│   └── admin-menu.blade.php    # Admin sidebar
├── browse/
│   └── index.blade.php         # Browse releases page
├── details/
│   └── index.blade.php         # Release details page
├── search/
│   └── index.blade.php         # Search page
├── home/
│   └── index.blade.php         # Homepage
└── admin/
    └── dashboard.blade.php     # Admin dashboard

Migration Helper Tool

Use the included migration script to help convert Smarty templates:

php migrate-templates.php resources/views/themes/Gentele/browse.tpl

This will:

• Convert Smarty syntax to Blade syntax
• Suggest the output filename
• Show a preview before saving
• Create necessary directories

Controller Migration Pattern

Before (Smarty):

public function index(Request $request)
{
    $this->setPreferences();
    $data = SomeModel::all();
    
    $this->smarty->assign('data', $data);
    $this->smarty->assign('meta_title', 'Page Title');
    
    $content = $this->smarty->fetch('template.tpl');
    $this->smarty->assign(compact('content', 'meta_title'));
    $this->pagerender();
}

After (Blade):

public function index(Request $request)
{
    $this->setPreferences();
    $data = SomeModel::all();
    
    $this->viewData = array_merge($this->viewData, [
        'data' => $data,
        'meta_title' => 'Page Title',
    ]);
    
    return view('module.index', $this->viewData);
}

TailwindCSS Classes

Common Bootstrap to Tailwind conversions:

Bootstrap	TailwindCSS
container	container mx-auto px-4
row	grid grid-cols-12 or flex
col-md-6	md:col-span-6 or md:w-1/2
btn btn-primary	px-4 py-2 bg-blue-600 text-white rounded hover:bg-blue-700
card	bg-white rounded-lg shadow-sm
d-flex justify-content-between	flex justify-between
mb-3	mb-3 (same)
text-center	text-center (same)

Next Controllers to Migrate

Priority order for remaining migrations:

1. SearchController - High traffic page
2. MovieController - Popular feature
3. SeriesController - Popular feature
4. ProfileController - User management
5. Admin Controllers - Admin functionality

For each controller:

1. Update the controller method to use $this->viewData and return view()
2. Create corresponding .blade.php file
3. Convert Smarty syntax to Blade
4. Update CSS from Bootstrap to TailwindCSS
5. Test thoroughly

Testing Checklist

• Browse pages load correctly
• Release details show all information
• Search functionality works
• User authentication works
• Admin panel is accessible
• Forms submit properly
• AJAX endpoints work
• Responsive design on mobile
• No console errors
• All images/assets load

Common Issues & Solutions

Issue: Views not updating

php artisan view:clear

Issue: CSS not applying

npm run build
php artisan cache:clear

Issue: Routes not working

php artisan route:clear
php artisan config:clear

Resources

• Laravel Blade Docs
• TailwindCSS Docs
• MIGRATION_GUIDE.md - Detailed migration guide

Notes

• All new views extend either layouts.main or layouts.admin
• Use @auth / @guest for authentication checks
• Use @can() for permission checks
• TailwindCSS is configured to scan all blade files
• Vite handles asset compilation