This project is a simple contact management system built with Laravel and Vue.js. It allows users to manage their contacts and contact groups efficiently.
- Prerequisites
- Backend Setup (Laravel)
- Frontend Setup (Vue.js with Inertia.js)
- Troubleshooting
- License
- PHP >= 7.3
- Composer
- Node.js >= 12.x
- npm or yarn
- MySQL or any other database supported by Laravel
-
Clone the Repository
git clone https://github.com/principalkelvo/contacts-manager.git cd your-repository
-
Install PHP Dependencies
composer install
-
Copy .env File
cp .env.example .env
-
Generate Application Key
php artisan key:generate
-
Configure Database
DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=your_database_name DB_USERNAME=your_database_user DB_PASSWORD=your_database_password
-
Run Migrations
php artisan migrate
-
Start the Laravel Development Server
php artisan serve
-
Install Node.js Dependencies
npm install
-
Compile Assets
npm run dev
-
Run the Tests
npx playwright test
-
Database Connection Issues: Double-check your .env configuration.
-
Services Not Running: Ensure all required services (database, server) are running before executing commands.
-
Migration Errors: Verify your Laravel migration files are correctly configured and run migrations again if necessary:
php artisan migrate:fresh
This project is licensed under the MIT License.