Meo Mai Moi ​

Mèo means cat. Mãi suggests forever, again and again. Mới means new, renewed.

Cats, always renewed.

Meo Mai Moi is a pet care platform with health tracking, vaccination reminders, weight monitoring, and rehoming features. It grew out of a real rescue life in Vietnam: nine former street cats, too many moving parts to remember safely, and the familiar developer spell, "I'll build a small app for myself."

The result is a Laravel 12 + React 19 monorepo with PostgreSQL, Filament admin, OpenAPI-generated frontend types, and a philosophy that stays stubbornly focused on animals and the people who care for them.

Start Here ​

• Project overview and values: README, Philosophy
• Local setup, testing, and workflow: Development Guide
• Technical structure and standards: Architecture
• Product capabilities: Features
• Deployment and operations: Deploy, Troubleshooting

Product Areas ​

• Pet profiles and care records: Pet Profiles
• Sharing, ownership, and foster flows: Pet Relationship System
• Rehoming workflow: Placement Request Lifecycle
• Community helpers: Helper Profiles
• Taxonomy and classifications: Categories
• Notifications and delivery channels: Notifications, Push Notifications
• Invitations and collaboration: Invites

Platform Reference ​

• Auth and session model: Authentication
• API envelope and conventions: API Conventions
• External API contract and quotas: API Integration
• Localization strategy: i18n
• Test coverage map for main user journeys: E2E Coverage Map
• Rate limits: Rate Limiting
• Roles and permissions: Roles
• Release workflow: Release, Upgrading

Running It ​

git clone https://github.com/troioi-vn/meo-mai-moi.git
cd meo-mai-moi
./utils/deploy.sh --seed

Then open localhost:8000 for the app, localhost:8000/admin for admin, and localhost:8000/api/documentation for the API docs.