Skip to main content

Direct Installation Guide

This guide will help you set up CueHired directly on your local machine for development without using Docker.

CueMeet Setup​

Before proceeding with CueHired installation, you'll need to set up CueMeet first. Please follow the CueMeet local setup guide to install and configure CueMeet on your system.

Prerequisites​

Before you begin, ensure you have the following installed:

  • Node.js (v18 or higher)
  • Yarn package manager
  • PostgreSQL (latest version)
  • Redis (latest version)
  • Git

Getting the Code​

  1. Clone the repository:
git clone <repository-url>
cd cuemeet/Apps/CueHire

Project Folder Structure​

Click to expand folder structure
.
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── SECURITY.md
├── UPGRADE.md
├── .github/
├── backend/
│   ├── Dockerfile
│   ├── README.md
│   ├── dist/
│   ├── nest-cli.json
│   ├── package.json
│   ├── src/
│   ├── test/
│   ├── tsconfig.build.json
│   ├── tsconfig.json
│   └── yarn.lock
├── docs/
├── docker-compose.yml
├── frontend/
│   ├── Dockerfile
│   ├── README.md
│   ├── dist/
│   ├── public/
│   ├── src/
│   ├── index.html
│   ├── package.json
│   ├── tsconfig.json
│   ├── tsconfig.app.json
│   ├── tsconfig.node.json
│   ├── vite.config.ts
│   ├── tailwind.config.ts
│   ├── postcss.config.js
│   ├── components.json
│   └── yarn.lock
└── assets
    ├── banner.png
    └── cuemeet-logo.png

Backend Setup​

  1. Navigate to the backend directory:
cd backend
  1. Install dependencies:
yarn install
  1. Set up environment variables:
Click to view/copy Backend API .env configuration
NODE_ENV=
PORT=

ORIGIN=

POSTGRES_USER=
POSTGRES_PASSWORD=
POSTGRES_DB=
POSTGRES_HOST=
POSTGRES_PORT=

REDIS_HOST=
REDIS_PORT=

GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
GOOGLE_REDIRECT_URI=

JWT_ACCESS_SECRET=
JWT_REFRESH_SECRET=

CUEMEET_BASE_URL=

GEMINI_API_KEY=

⚠️ Important: The CueMeet-related environment variables must be obtained from the CueMeet Setup Guide. Complete the CueMeet setup first and copy the relevant values into this file.

  1. Start the development server:
yarn start:dev

Frontend Setup​

  1. Navigate to the frontend directory:
cd frontend
  1. Install dependencies:
yarn install
  1. Set up environment variables:
Click to view/copy Frontend .env configuration
VITE_GOOGLE_AUTH_URL=
VITE_GRAPHQL_URL=
  1. Start the development server:
yarn dev

Verifying the Installation​

  1. Backend API should be running at: http://localhost:8080
  2. Frontend application should be running at: http://localhost:5173

Common Issues​

Database Connection Issues​

  • Ensure PostgreSQL is running
  • Check database credentials in .env file
  • Verify database port is not blocked

Port Conflicts​

  • If port 3000 is in use, modify the backend port in .env
  • If port 5173 is in use, modify the frontend port in vite.config.ts

Node Version Issues​

  • Use nvm to switch to the correct Node.js version
  • Ensure you're using Node.js v18 or higher

Redis Connection Issues​

  • Ensure Redis server is running
  • Check Redis connection settings in .env file
  • Verify Redis port is not blocked