1. Nodejs Configuration

1.1 Nodejs Configuration

Kindly navigate to your project's folder.

1. You must verify that Npm (v10.2.4) and Node (v20.11.1) are installed for the relevant version. If you're not sure about the version, try to run the given command in the command prompt: npm run check-version

2. If both the Node and Npm versions match, then the screen will display the output as shown below:\

   

Else, the screen will display the output as shown below:

Kindly check if Node is pre-installed in your system. If not, then you need to install it before running Step 1.

Reference to Node Installation:

1. Node.js Official Website
2. Using NVM https://github.com/nvm-sh/nvm?tab=readme-ov-file#installing-and-updating

1.2 Vue CLI install

After the completion of node configuration you need to install the Vue cli using the following Command. Also you can refer to the official site.

npm install -g @vue/cli
# OR
yarn global add @vue/cli

After installation, you will have access to the vue binary in your command line. You can verify that it is properly installed by simply running vue, which should present you with a help message listing all available commands.

You can check you have the right version with this command:

vue --version

2. Server Startup

2.1 Start Server and Installation

Go back to your command prompt after completing Step 1. Now, use the command:

npm run basic-install

NOTE: if this step thows issue related to the BUILD failure, then you can follow this steps in your terminal

// Considering working directory as projects root directory
> cd installation
> npm run build

// On successful build completion, change directory to root
> cd ..

// Run the server using any of the below commands
> npm run start 
// OR
> node server.js

This command will generate env files and a build for installation.

When the command is done, it will display the output on your command prompt as shown on the screen below.

Thereafter, navigate to http://localhost:4000 in your browser.

3. Installation Guide

Please make sure to follow through the installation guide properly without skipping any step.

Please follow this document

Time Tracker Configuration

Time Tracker Setup

1. Please make sure you have setup Alianhub before you setup time tracker. You need to verify that Npm (v10.2.4) and Node (v20.11.1) are installed for the relevant version in your system.
2. Also, make sure that you install the correct version of Python before moving forward with Time Tracker. The required version of Python is v2.7.2. Download from Here.
3. If you are generating build from mac, you must have Xcode installed.

Kindly check if Node is pre-installed in your system. If not, then you need to install it before running Step 1.

Reference to Node Installation:

1. Node.js Official Website

2. Using NVM https://github.com/nvm-sh/nvm?tab=readme-ov-file#installing-and-updating

3. After checking the node version you need to create a .env file. For creating a .env file go to the Renderer folder in your project. As shown in the image below.

4. Then in the renderer folder create file name .env.
   \

   

Note: It is necessary to add '.' (dot in prefix in name of env variable). Make sure you add it.

5. In that .env file add the variables as shown below.
   
   APIURL=

   APP_MONGO_APP_ID=

   APP_MONGO_CONNECTION_URI=
   
   You need to insert the APIURL, which corresponds to the APIURL listed in your Alian hub environment file. For the values of APP_MONGO_APP_ID and APP_MONGO_CONNECTION_URI, use the same values as MONGO_APP_ID and MONGODB_URL from your Alian hub environment file, respectively.\

6. In package.json, if you don't have credentials for certificate while generating build, it is recommended that you remove the following keys from package.json:

   • certificateFile
   • certificatePassword

7. After setup of your .env file you need to generate a build for time tracker.
   
   First you have to install all the packages with the following command:

   Command: 'npm install' or 'npm install --legacy-peer-deps'

   Then to generate a build, in your root folder hit the following command according to your OS.

   Windows : 'npm run build'

   iOS: 'npm run build:ios'

   Linux: 'npm run build'\

8. After generating the build redirect to the dist folder. As shown in the image below.

9. At dist folder application is generated and ready to install.