Skip to content
XetaSuite

Run locally

Prerequisites

Section titled “Prerequisites”

Make sure you have completed:

Quick start

Section titled “Quick start”
Section titled “With Laravel Herd (Recommended)”

If you use Laravel Herd, the backend is automatically available at https://xetasuite-core.test.

  1. Start backend services

    Terminal window
    cd XetaSuite-core
    composer run dev

    This command launches:

    • The Laravel server
    • The queue worker

  2. Start the frontend

    Terminal window
    cd XetaSuite-React
    npm run dev

  3. Access the application

    Open http://localhost:5173 in your browser.

Without Herd

Section titled “Without Herd”
Terminal window
cd XetaSuite-core
php artisan serve

Demo account

Section titled “Demo account”

After running the seeders, you can log in with:

EmailPasswordRole
admin@xetasuite.testpasswordHQ Admin
manager@xetasuite.testpasswordSite 1 Manager
user@xetasuite.testpasswordSite 1 User

Useful commands

Section titled “Useful commands”

Backend

Section titled “Backend”
Terminal window
# Run tests
php artisan test


# Run a specific test
php artisan test --filter=CompanyController


# Refresh the database
php artisan migrate:fresh --seed


# Format code
vendor/bin/pint --dirty

Frontend

Section titled “Frontend”
Terminal window
# Development server
npm run dev


# Production build
npm run build


# Run linter
npm run lint

Troubleshooting

Section titled “Troubleshooting”

CORS errors

Section titled “CORS errors”

Check that SPA_URL in .env matches your frontend URL:

Terminal window
SPA_URL=http://localhost:5173

419 CSRF token mismatch

Section titled “419 CSRF token mismatch”

Make sure you’re calling /sanctum/csrf-cookie before login:

await axios.get('/sanctum/csrf-cookie');
await axios.post('/api/v1/auth/login', credentials);

Session not persisting

Section titled “Session not persisting”

Check these settings:

SANCTUM_STATEFUL_DOMAINS=localhost:5173,xetasuite.test
SESSION_DOMAIN=localhost