Quick Start

Get Mini CRM running locally in under 5 minutes.

Prerequisites

1. Clone the repository

bash

git clone https://github.com/XgeniousLLC/geniousCRM.git
cd geniousCRM

2. Install PHP dependencies

bash

composer install

3. Install JavaScript dependencies

bash

npm install

4. Configure your environment

bash

cp .env.example .env
php artisan key:generate

Open .env and set your database credentials:

env

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=mini_crm
DB_USERNAME=root
DB_PASSWORD=your_password

5. Run migrations and seed

bash

php artisan migrate --seed

This creates the default roles, permissions, and the admin account:

Email	Password	Role
`admin@minicrm.test`	`password`	Admin

6. Build the frontend

bash

npm run build

7. Start the server

bash

php artisan serve

Open http://localhost:8000 and log in with admin@minicrm.test / password.

To populate the CRM with realistic demo contacts, leads, deals, tasks, and companies:

bash

php artisan db:seed --class=DemoSeeder

This adds 15 contacts, 12 leads, 10 deals, 15 tasks, 8 companies, and 4 users. See Demo Reset for more.