almirfrances/tanzaadmin

A Laravel admin panel starter kit.

1.2.0 2025-03-30 17:51 UTC

Requires

• php: ^8.2
• guzzlehttp/guzzle: ^7.9
• laravel/framework: ^11.31
• laravel/socialite: ^5.16
• laravel/tinker: ^2.9
• mailjet/laravel-mailjet: ^3.1
• nwidart/laravel-modules: ^11.1
• php-flasher/flasher-sweetalert-laravel: ^2.1
• phpmailer/phpmailer: ^6.9
• spatie/laravel-backup: ^9.2
• symfony/mailjet-mailer: ^6.4
• symfony/sendgrid-mailer: ^7.2

Requires (Dev)

• fakerphp/faker: ^1.23
• laravel/pail: ^1.1
• laravel/pint: ^1.13
• laravel/sail: ^1.26
• mockery/mockery: ^1.6
• nunomaduro/collision: ^8.1
• phpunit/phpunit: ^11.0.1

MIT

• framework
• laravel

README

One-Step Installation

Run these commands to create the project and complete installation:

composer create-project almirfrances/tanzaadmin

cd tanzaadmin

php artisan tanzaadmin:install

The process will:

1. Create project directory
2. Install dependencies
3. Configure environment
4. Set up database
5. Initialize admin system

Installation Flow

During installation, you'll be prompted for:

✔ Application Name (default: TanzaAdmin)
✔ Application URL (default: http://localhost:8000)
✔ Database Configuration:

• Host (default: 127.0.0.1)
• Port (default: 3306)
• Database Name
• Username (default: root)
• Password

Post-Installation

After successful installation:

1. Start development server:

   php artisan serve
   

2. Build frontend assets:

   npm install && npm run dev
   

Admin Access

Default credentials:

• URL: http://localhost:8000/admin
• Username: admin
• Password: tanzaadmin

Configuration

Edit .env file for:

• Email settings
• Cache configuration
• Session driver
• Debug mode

Troubleshooting

Database Connection Issues

1. Verify MySQL/MariaDB service is running
2. Check credentials in .env
3. Ensure database exists
4. Test connection manually:

   mysql -u [username] -p [dbname]
   

Environment Issues

1. Regenerate environment:

   rm .env && php artisan tanzaadmin:install
   

2. Clear configuration cache:

   php artisan config:clear
   

File Permissions

Set proper permissions:

chmod -R 755 storage
chmod -R 755 bootstrap/cache

Maintenance

🔹 Update to New Version:

composer update almirfrances/tanzaadmin

🔹 Reset Installation:

php artisan tanzaadmin:install --force

Support

• GitHub: https://github.com/almirfrances/tanzaadmin
• Issues: https://github.com/almirfrances/tanzaadmin/issues

Version Info

• Current Stable: 1.2.0
• PHP Required: 8.1+
• Laravel Version: 10.x
• Database: MySQL 5.7+ / MariaDB 10.3+