Installation
Note:
Jidox offers enhanced real-time customization of your
layout through the use of CSS variables, which are set
via Sass.
If you are not familiar with Node.js and Gulp, don't
worry. We've provided a ready-to-use (pre-compiled)
version of Jidox in the dist folder, which
you can use without any additional setup steps. However,
if you want to take full advantage of Jidox's
customization options, we recommend following the setup
steps below to install Node.js and Gulp and build your
own version of the template.
We utilize Gulp to automate our build flow, allowing for complete automation of our development workflows. Gulp is a powerful toolkit designed to help developers eliminate time-consuming tasks, allowing them to focus on what really matters: building great products. If you're not familiar with Gulp, you can learn more about it here.
Prerequisites
To get started with Jidox, please follow the steps below to install and set up all the necessary prerequisites:
-
Node.js - v16x or v18x
To use our build tools and take full advantage of Jidox's customization options, you will need to download and install Node.js. If you do not have Node.js v16.x or v18.x installed already, you can download the package installer from the official website. We recommend that you download the stable version of Node.js (LTS) to ensure the best possible experience.
Download Node.js -
Git
Ensure that you have Git installed and running on your system.
Install Git -
Gulp & Gulp CLI
Ensure that you have Gulp installed and running on your computer. If you already have Gulp installed, you can skip this step. If not, you can install it by running the following command from your terminal:
npm install -g gulp@4.0.1. -
Yarn
Ensure that you have Yarn installed and running on your computer. If you already have Yarn installed, you can skip this step.
Installation
To install all the required dependencies for the template,
open your terminal, navigate to the folder where you have
the Jidox files, and run the command
yarn install. This will install all necessary
dependencies in the node_modules folder. Once
the installation is complete, you are ready to run Jidox
for the first time.
You can run the following commands to run projects locally: Or build for production use:
| Command | Description |
|---|---|
gulp |
Runs the "vertical" demo locally, starts the development server and watches for any changes in your code, including your html, javascript, sass, etc. The development server is accessible at http://localhost:3000/. |
gulp build |
It compiles the source assets including scss and bundles into production ready use. |
Troubleshooting
-
If you encounter the error message "
Error: ENOENT: no such file or directory, scandir '/root/website/node_modules/node-sass/vendor'" while running npm install, there are a couple of things you can try to resolve it:-
1. Run
npm rebuild node-sassto re-install node-sass -
2. Delete node_modules folder and re run
npm install
-
1. Run