https://github.com/lukacavic/vetlio
A modern, multi-tenant CRM for veterinary practices — scheduling clients & patients, invoicing, medical documents, offers, orders, and more.
https://github.com/lukacavic/vetlio
crm filamentadmin filamentphp laravel veterinary veterinary-clinic
Last synced: 5 months ago
JSON representation
A modern, multi-tenant CRM for veterinary practices — scheduling clients & patients, invoicing, medical documents, offers, orders, and more.
- Host: GitHub
- URL: https://github.com/lukacavic/vetlio
- Owner: lukacavic
- License: mit
- Created: 2025-11-09T15:31:22.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-11-17T12:11:41.000Z (7 months ago)
- Last Synced: 2025-11-17T14:10:11.522Z (7 months ago)
- Topics: crm, filamentadmin, filamentphp, laravel, veterinary, veterinary-clinic
- Language: PHP
- Homepage:
- Size: 4.39 MB
- Stars: 35
- Watchers: 2
- Forks: 6
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Vetlio
[](../../discussions)
[](../../issues)
[](../../pulls)
[](LICENSE)
[](../../stargazers)
A modern, multi-tenant CRM for veterinary practices — scheduling clients & patients, invoicing, medical documents, offers, orders, and more. Built with **Laravel 12** and **Filament 4.1**.
> WARNING: **Alpha Stage** — not production ready. Expect breaking changes and incomplete features.
---
## Features
* Appointments: clients & patients, slot availability, reminders
* Billing: invoices, items, taxes, payments
* Medical docs: findings, attachments, print/PDF
* Multi‑tenancy (SaaS)
* Role & permission model (per user / per location)
* Search, filters, exports, PDF prints
## Tech Stack
* **Laravel 12**, PHP 8.3+
* **Filament 4.1** (panels, resources, actions)
* MySQL/MariaDB, Redis (cache/queue)
* Pest for tests
* Docker/Sail (optional)
---
## Quick Start
### Prerequisites
* PHP 8.3+, Composer
* Node 20+, PNPM/NPM
* MySQL 8+ (or MariaDB 10.6+), Redis
* (Optional) Docker & Docker Compose
### 1) Clone & install
```bash
git clone https://github.com/lukacavic/vetlio.git
cd vetlio
composer install
cp .env.example .env
php artisan key:generate
```
### 2) Configure `.env`
```env
APP_NAME=Vetlio
APP_ENV=local
APP_KEY=
APP_DEBUG=true
APP_URL=https://vetlio.test
APP_LOCALE=en
APP_FALLBACK_LOCALE=en
APP_FAKER_LOCALE=en_US
APP_MAINTENANCE_DRIVER=file
# APP_MAINTENANCE_STORE=database
# PHP_CLI_SERVER_WORKERS=4
BCRYPT_ROUNDS=12
LOG_CHANNEL=stack
LOG_STACK=single
LOG_DEPRECATIONS_CHANNEL=null
LOG_LEVEL=debug
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=vetlio
DB_USERNAME=root
DB_PASSWORD=
SESSION_DRIVER=database
SESSION_LIFETIME=120
SESSION_ENCRYPT=false
SESSION_PATH=/
SESSION_DOMAIN=null
BROADCAST_CONNECTION=log
FILESYSTEM_DISK=local
QUEUE_CONNECTION=database
CACHE_STORE=database
# CACHE_PREFIX=
MEMCACHED_HOST=127.0.0.1
REDIS_CLIENT=phpredis
REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379
MAIL_MAILER=log
MAIL_SCHEME=null
MAIL_HOST=127.0.0.1
MAIL_PORT=2525
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_FROM_ADDRESS="hello@vetlio.com"
MAIL_FROM_NAME="${APP_NAME}"
AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=
AWS_USE_PATH_STYLE_ENDPOINT=false
VITE_APP_NAME="${APP_NAME}"
```
### 3) Database & storage
```bash
php artisan migrate --seed
php artisan storage:link
```
### 4) Assets & dev server
```bash
npm install
npm run build
```
### 5) Run app
1. Create subdomain `org1.vetlio.test` in your hosts file.
2. Navigate to https://org1.vetlio.test/app/login
3. Login with email `admin@org1.com` and password `password`
---
### 6) Login to admin panel
1. Navigate to https://org1.vetlio.test/admin/login
2. Login with email `admin@admin.com` and password `admin`
### 7) Login to portal
1. Navigate to https://org1.vetlio.test/portal/login
2. Find `client email` from database for email and for password use `portal`
## Community & Feedback
All updates about new features, improvements, and upcoming changes are shared in the [Announcements](../../discussions/categories/announcements) section.
If you have ideas or suggestions for what you’d like to see next in Vetlio, you can post them in the [Ideas & Feedback](../../discussions/categories/ideas) section.
Every idea helps shape the direction of Vetlio and shows where the most interest is coming from.
Vetlio is still in its early stages, and your input is incredibly valuable — feel free to join the discussions, share your thoughts, or comment on ideas from others.
## Contributing
1. Fork & create a feature branch
2. Run tests and static analysis
3. Open a PR with a clear description & screenshots (if UI)
Code style: `vendor/bin/pint` · Static analysis: `vendor/bin/phpstan analyse`