Inficom Docs

Quick Start Guide

Get your Inficom Solutions application up and running in just a few steps.

What We'll Do

This guide will walk you through the complete setup process

Backend Setup (5-10 minutes)

  • Download and install dependencies
  • Configure database connection
  • Start the backend server

Frontend Setup (5-10 minutes)

  • Download and install dependencies
  • Configure environment variables
  • Start the frontend development server

1Download the Project

Get the complete application code

Option 1: Download ZIP File

Download the complete project as a ZIP file and extract it to your desired location.

📁 Extract to: C:\\Users\\YourName\\Desktop\\inficom-solutions

Option 2: Using Git (if you have it installed)

# Navigate to your desired directory
cd C:\\Users\\YourName\\Desktop
# Clone the repository (replace with actual repository URL)
git clone https://github.com/your-username/inficom-solutions.git
# Navigate into the project directory
cd inficom-solutions

2Set Up the Backend

Install dependencies and configure the server

Step 2.1: Navigate to Backend Directory

# Open Command Prompt (Windows) or Terminal (Mac/Linux)
# Navigate to the server directory
cd inficom-solutions/server

Step 2.2: Install Dependencies

# Install all required packages
npm install

This may take a few minutes. You'll see a progress bar and then a success message.

Step 2.3: Configure Environment Variables

Important

Create a .env file in the server directory with your database credentials. WhatsApp integration settings are managed from the frontend admin panel (see below) after the server is started — you do not need to store WhatsApp tokens in the backend .env by default.

Create a file named .env in the server directory with this content:

# Database Configuration
DB_HOST=localhost
DB_USER=root
DB_PASSWORD=your_mysql_password
DB_NAME=inficom_solutions
DB_PORT=3306
# Server Configuration
PORT=5000
JWT_SECRET=your_jwt_secret_key_here
# Note: WhatsApp Instance ID and Access Token are configured from the frontend admin panel after starting the app.

Step 2.4: Create Database

# Connect to MySQL
mysql -u root -p
# Enter your MySQL password when prompted
# Create the database
CREATE DATABASE inficom_solutions;
# Exit MySQL
EXIT;

Step 2.5: Start the Backend Server

# Start the server
npm run dev

You should see messages like "Server running on port 5000" and "Database connected successfully".

3Set Up the Frontend

Install dependencies and configure the client

Step 3.1: Navigate to Frontend Directory

# Open a new Command Prompt/Terminal window
# Navigate to the frontend directory
cd inficom-solutions/client

Step 3.2: Install Dependencies

# Install all required packages
npm install

This may take a few minutes. You'll see a progress bar and then a success message.

Step 3.3: Configure Environment Variables

Important

Create a .env.local file in the client directory. Backend API URL is required here; WhatsApp settings are configured via the admin panel after startup.

Create a file named .env.local in the nextjssite directory with this content:

# Backend API URL
NEXT_PUBLIC_BACKEND_URL=http://localhost:5000/api

Step 3.4: Start the Frontend Development Server

# Start the development server
npm run dev

You should see messages like "Ready - started server on 0.0.0.0:3000" and a local URL.

Step 3.5: Configure WhatsApp Integration (Admin Panel)

After starting both backend and frontend, WhatsApp settings are configured from the frontend admin panel. Follow these steps:

  1. Open the admin panel in your browser (for example: http://localhost:3000/admin).
  2. Sign in with an admin account.
  3. Go to Settings → WhatsApp Integration (or similar).
  4. Paste your Instance ID and Access Token provided by your WhatsApp provider and save.
  5. The backend will use these values from the admin settings for sending messages.

4Verify Installation

Make sure everything is working correctly

✅ Backend Server

Open your browser and go to http://localhost:5000. You should see a message like "Server is running".

✅ Frontend Application

Open your browser and go to http://localhost:3000. You should see the Inficom Solutions website.

🎉 Congratulations!

Your Inficom Solutions application is now running successfully! You can start exploring the features and customizing the application to your needs.

Common Issues & Solutions

If you encounter any problems, check these solutions

❌ "Command not found" errors

Make sure Node.js and MySQL are properly installed and added to your system PATH. Try restarting your command prompt/terminal after installation.

❌ Database connection errors

Verify that MySQL is running and the credentials in your .env file are correct. Make sure the database "inficom_solutions" exists.

❌ Port already in use

If port 3000 or 5000 is already in use, you can change the ports in your .env files or stop the conflicting applications.

❌ npm install fails

Make sure you have a stable internet connection. Try clearing npm cache withnpm cache clean --force and run install again.

What's Next?

Now that your application is running, you can explore the detailed documentation for each component.

Frontend DocumentationBackend Documentation