Configuring Loom

After installation, configure your project for a smooth experience.

---

1️⃣ Environment Variables

Ensure your .env file contains:

APP_NAME="My Loom App"
APP_ENV=local
APP_KEY=base64:GENERATED_KEY
APP_DEBUG=true
APP_URL=http://localhost:5173

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

BROADCAST_DRIVER=log
CACHE_DRIVER=file
QUEUE_CONNECTION=sync
SESSION_DRIVER=file

Tips:

• APP_URL should match your frontend dev server.
• Verify database credentials before running migrations.

---

2️⃣ Module Configuration

Edit config/loom.php to enable, disable, or configure modules:

return [
    'modules' => [
        'users' => true,
        'projects' => true,
        'billing' => false,
        // Add or remove modules as needed
    ],
];

Notes:

• Modules can be activated or deactivated without touching core code.
• Custom modules can be added to app/Modules or via package.

---

3️⃣ Frontend & Tools

• If using Bun / Vite: run bun install after adding frontend packages.
• Adjust APP_URL for Hot Reloading if needed.
• Customize Tailwind config, Livewire components, and Alpine scripts as required.

---

4️⃣ Advanced Configuration

• Cache, queues, and session drivers can be modified in .env and config/loom.php.
• Deployments (SaaS / On-prem) can have separate .env files for each environment.
• Refer to guides/deployment for full instructions.