Before installing the TallPress - Laravel Blog Package, ensure your system meets these requirements:

• PHP: 8.1 or higher
• Laravel: 10.0 or higher
• Database: MySQL/MariaDB
• Livewire: 3.0 or higher (automatically installed with this package)

composer require sajdoko/tallpress

The package will automatically:

• Register its service provider via Laravel's package discovery
• Install Livewire 3 as a dependency
• Set up all required dependencies

Publish the configuration file to customize settings:

php artisan vendor:publish --provider="Sajdoko\TallPress\TallPressServiceProvider" --tag=tallpress-config

This creates config/tallpress.php where you can customize:

• Posts per page
• User model
• Storage disk
• Route prefixes
• And much more

Create the required database tables:

php artisan migrate

This creates:

• tallpress_posts - Blog posts
• tallpress_categories - Categories
• tallpress_tags - Tags
• tallpress_post_category - Post-category pivot
• tallpress_post_tag - Post-tag pivot
• tallpress_comments - Comments
• tallpress_post_revisions - Post version history
• tallpress_activity_logs - Admin activity tracking
• tallpress_media - Media files
• tallpress_settings - Dynamic settings

The blog is now installed and ready to use:

• Public Blog: /blog
• Admin Interface: /admin/blog

No build step required! Assets are precompiled and work immediately.

Your admin dashboard is ready to use immediately after installation

For a faster setup with demo data:

php artisan tallpress:install --seed

This command:

1. ✅ Publishes configuration
2. ✅ Runs migrations
3. ✅ Initializes default settings
4. ✅ Creates demo users (admin, editor, author)
5. ✅ Seeds sample posts, categories, and tags

Demo Credentials:

If you want to customize the CSS/JS:

php artisan vendor:publish --tag=tallpress-assets

This copies precompiled assets to public/vendor/tallpress/:

Frontend (Public Blog):

• css/tallpress-frontend.css - Lightweight styling for public pages
• js/tallpress-frontend.js - Minimal JavaScript for public pages

Admin (Admin Panel):

• css/tallpress-admin.css - Complete styling including Quill editor
• js/tallpress-admin.js - JavaScript with Quill rich text editor

To customize Blade templates:

php artisan vendor:publish --tag=tallpress-views

Views are published to resources/views/vendor/tallpress/ for customization.

For multilingual support or custom translations:

php artisan vendor:publish --tag=tallpress-lang

Language files are published to resources/lang/vendor/tallpress/.

To publish all resources at once:

php artisan vendor:publish --provider="Sajdoko\TallPress\TallPressServiceProvider"

The admin interface is built with Livewire v3, providing a modern, reactive experience.

• ✅ Livewire automatically installed as a dependency
• ✅ @livewireStyles and @livewireScripts included in admin layout
• ✅ No additional configuration required
• ✅ Works out of the box

• Real-time updates - No page reloads for most actions
• Live search and filtering - Instant results as you type
• Inline editing - Edit categories and tags without separate forms
• File uploads - Live upload progress and preview
• Bulk actions - Select and process multiple items at once

After installation:

1. Configure the package - See Configuration Guide
2. Create your first post - Visit /admin/blog and log in
3. Customize the design - See Styling & Assets
4. Learn the features - Read the Usage Guide

If styles aren't appearing:

php artisan vendor:publish --tag=tallpress-assets --force
php artisan view:clear
php artisan cache:clear

Ensure Livewire is properly installed:

composer show livewire/livewire

If not found, manually install:

composer require livewire/livewire:^3.0

If you get table conflicts:

php artisan migrate:fresh  # ⚠️ WARNING: Deletes all data

Or selectively run blog migrations:

php artisan migrate --path=/vendor/sajdoko/tallpress/database/migrations

If you can't access /admin/blog:

1. Ensure you're logged in
2. Check your user has a role field set to admin, editor, or author
3. Run the seeder to create demo users:

php artisan db:seed --class="Sajdoko\TallPress\Database\Seeders\TallPressAdminSeeder"

To update to the latest version:

composer update sajdoko/tallpress
php artisan migrate  # Run new migrations if any
php artisan view:clear

If you've published assets, re-publish to get the latest:

php artisan vendor:publish --tag=tallpress-assets --force

Installation complete! Continue to the Configuration Guide →