fahimhossainmunna/quick-setup

A Laravel quick setup automation package that instantly configures your project by generating the .env file, setting up environment values, installing Composer and NPM dependencies, running migrations and seeders, linking storage, and clearing caches — all with a single Artisan command.

v1.1.0 2025-11-01 13:10 UTC

Requires

• php: >=8.1
• illuminate/support: ^10.0|^11.0|^12.0
• symfony/process: ^6.0 || ^7.0

MIT

• Fahim Hossain Munna

README

A lightweight and time-saving Composer package that helps you automatically set up a freshly cloned Laravel project with a single command.
No more manual .env copying, dependency installation, or migration hassle — just run one command and get started!

🧠 About The Project

When we clone a Laravel repository from GitHub, we usually need to:

• Copy .env.example → .env
• Run composer install and npm install
• Generate the application key
• Set up database credentials
• Run migrations and link storage
• Configure app URL and other environment values

Doing this repeatedly can be frustrating — especially for teams.
So this package provides a bash-powered automation tool that executes all these steps with a single command.
Perfect for developers who want a faster, cleaner, and repeatable setup workflow.

✨ Features

• 🔁 Auto-create .env from .env.example
• 🧩 Run composer install and npm install
• 🔑 Auto-generate app key
• 🗄️ Run database migrations
• 🔗 Link Laravel storage
• ⚙️ Optionally set APP_URL, DB_* configs
• 🧹 Clean and minimal — no heavy dependencies

⚙️ Installation

You can install it globally or directly inside your Laravel project.

First-Time Installation (fresh Laravel project)

composer install
composer require fahimhossainmunna/quick-setup

Once installed, simply run the following Artisan command:

composer install
php artisan run:quick-setup

🛠️ Troubleshooting

If something doesn’t work, try the following steps:

1. Ensure required tools are installed

   • PHP
   • Composer
   • Node.js
   • npm

2. Check your environment file

   • Make sure your .env file exists and contains valid database credentials.

3. Clear and refresh Laravel cache

   php artisan config:clear
   php artisan cache:clear

4. Fix file or directory permissions - If you encounter permission errors, run:

    chmod -R 775 storage bootstrap/cache

Fahim Hossain Munna
🔗 Packagist Profile
💻 GitHub Profile

🪪 License

This package is open-sourced software licensed under the MIT license.