Installation & Requirements

System Requirements

• PHP 8.1 or higher
• Composer 2.x
• Database MySQL 8.0+ / MariaDB 10.3+ / PostgreSQL 14+
• Node.js 18+ (for asset compilation)
• Web Server Apache / Nginx

Installation Steps

1. Clone the Repository

git clone https://github.com/your-org/shop-manager.git
cd shop-manager

2. Install Dependencies

composer install
npm install

3. Environment Configuration

cp .env.example .env
php artisan key:generate

Edit .env with your database credentials:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=shop_manager
DB_USERNAME=root
DB_PASSWORD=

4. Database Setup

php artisan migrate
php artisan db:seed

5. Storage Linking

php artisan storage:link

6. Compile Assets

npm run build

7. Serve the Application

php artisan serve

Visit http://localhost:8000 in your browser.

Deployment

For production, configure your web server to point to the public/ directory. Ensure the following directories are writable:

• storage/
• bootstrap/cache/
• public/uploads/

Optimization Commands

php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan optimize