Mini CRM

Mini CRM is a Laravel 12 application focused on user authentication and a clean private dashboard. It is a foundation for a small business management system that can be extended with customers, notes, tasks, and activity history.

Features

• User login and registration
• Protected dashboard available only for authenticated users
• Demo account seeded into the database
• SQLite database setup for local development
• Feature tests for the main authentication flow
• Blade views styled with Tailwind CSS and Vite

Tech Stack

• PHP 8.3
• Laravel 12
• SQLite
• Blade
• Tailwind CSS
• Vite
• PHPUnit

Demo Account

Email: admin@example.com
Password: password

Local Setup

Install PHP dependencies:

composer install

Install frontend dependencies:

npm install

Create the environment file:

cp .env.example .env

Generate the application key:

php artisan key:generate

Create the SQLite database file:

touch database/database.sqlite

Run migrations and seed the demo user:

php artisan migrate --seed

Start the Laravel server:

php artisan serve

Start Vite in a second terminal:

npm run dev

Open the application:

http://127.0.0.1:8000

Windows PHP Note

If PHP was installed through WinGet and no php.ini file is loaded, enable these PHP extensions:

mbstring
pdo_sqlite
openssl

As a temporary local workaround, PHP can also be started with the required extensions passed inline:

php -d extension_dir="<path-to-php>\ext" -d extension=mbstring -d extension=pdo_sqlite -d extension=openssl -S 127.0.0.1:8000 -t public

Then open the application:

http://127.0.0.1:8000

Tests

Run the test suite:

php artisan test

For the WinGet PHP setup above, PHPUnit can also be run directly with the required extensions:

php -d extension_dir="<path-to-php>\ext" -d extension=mbstring -d extension=pdo_sqlite -d extension=openssl vendor\bin\phpunit

Roadmap

• Customer management
• Customer notes and internal comments
• Task tracking
• Dashboard statistics
• Role-based access control