# UI Guidelines

## Overview

This is a **pure API backend**. There is no server-rendered UI. The frontend is a separate SPA application (likely React/Vue.js) that consumes this API.

The Laravel application only provides:
- API endpoints (JSON responses)
- File serving routes (images, documents, PDFs, APK files)
- Minimal `welcome` Blade view

## Frontend Build

- **Vite 7** with `laravel-vite-plugin`
- **Tailwind CSS v4** (loaded via `@tailwindcss/vite`)
- Entry points: `resources/css/app.css`, `resources/js/app.js`
- No UI frameworks or components exist in this repository

## Asset Serving

Files are served via dedicated web routes:

| Path Pattern | Content Type |
|-------------|--------------|
| `/storage/logos/accounts/{filename}` | Account logos |
| `/storage/companies_logo/{filename}` | Company logos |
| `/storage/profile_image/{filename}` | User profile images |
| `/storage/asset_images/{filename}` | User asset images |
| `/storage/visit_images/{filename}` | Visit photos |
| `/storage/project_files/{filename}` | Project files |
| `/storage/attendance_images/check-in/{filename}` | Check-in photos |
| `/storage/attendance_images/check-out/{filename}` | Check-out photos |
| `/apk_files/{filename}` | Mobile app APK distribution |

## Design Notes for API Consumers

- All responses follow the `{success, message, data}` envelope
- File uploads use `multipart/form-data`
- All authenticated requests use `Authorization: Bearer <token>` header
- There is no UI framework, component library, or design system defined in this repository

This section should be expanded by the frontend team with their specific UI conventions, color palette, typography, component library, and design system documentation.