Contact Management System

This is a Contact Management System built with Laravel. It allows users to manage their contacts and groups efficiently. Users can create, read, update, and delete contacts and groups, providing a simple yet powerful way to organize and keep track of their personal or professional network.

Table of Contents

• Introduction
• Features
• Technologies Used
• Prerequisites
• Installation
• Running the Project
• License

Introduction

The Contact Management System is designed to help users manage their contacts and group them as needed. This project includes user authentication and authorization features to ensure that users can securely manage their information.

Features

• User authentication and authorization
• CRUD operations for contacts
• CRUD operations for groups
• Group assignment for contacts
• Responsive design

Technologies Used

• Laravel
• PHP
• MySQL
• Blade Templating
• Tailwind CSS
• JavaScript

Prerequisites

Before you begin, ensure you have met the following requirements:

• PHP >= 7.3
• Composer
• MySQL
• Node.js and npm (for compiling assets)
• Git

Installation

Follow these steps to set up and run the project locally

1. Clone the Repository

git clone https://github.com/NjorogeMaurice/ContactManagement.git

cd ContactManagement

2. Install Dependencies

Use Composer to install PHP dependencies

composer install

Use npm to install JavaScript dependencies

npm install
npm run dev

3. Set Up Environment Variables

Create a .env and configure your environment variables, especially the database settings

Add the following lines. Replace with your credentials

DB_DATABASE=my_laravel_db
DB_USERNAME=laravel_user
DB_PASSWORD=your_password

4. Generate Application Key

php artisan key:generate

5. Run Database Migrations and Seeders

php artisan migrate --seed

Running the Project

You can serve/run the application using the built-in Laravel server:

php artisan serve

Then open your browser at http://localhost:8000.