MWALAJS SETUP

Objectives:

MwalaJS Installation Guide

MwalaJS Installation Guide

Version: Latest
Official Website: https://mwalajs.biasharabora.com

What You’ll Need

  • A computer (Windows preferred)
  • Internet connection
  • Basic computer knowledge (copy, paste, extracting files)
  • Node.js installed

Step-by-Step Installation Instructions

STEP 1: Download MwalaJS

  1. Open your browser and go to: https://mwalajs.biasharabora.com
  2. Choose one of the files:
    • MwalaJS.zip
    • MwalaJS.rar
  3. Download and save it to your computer (usually goes to your Downloads folder).

STEP 2: Extract the Downloaded File

  1. Go to your Downloads folder.
  2. Right-click on the downloaded file:
    • If ZIP → choose Extract All
    • If RAR → open with WinRAR or 7-Zip
  3. You’ll get a folder named mwalajs. Copy or cut this folder.

STEP 3: Move to Program Files

  1. Open C:\Program Files on your PC.
  2. Paste the mwalajs folder inside.
  3. If asked for administrator permission, click Continue.

STEP 4: Add to Environment Variable

This step allows you to run mwala command from any terminal window.
  1. Press Windows + S, type environment variables, and click on Edit the system environment variables.
  2. In the new window, click Environment Variables.
  3. Under System variables, select Path and click Edit.
  4. Click New, then paste the path: 
    C:\Program Files\mwalajs
  5. Click OK on all windows to save changes.

STEP 5: Test the Installation

  1. Open Command Prompt (Windows + R → type cmd → Enter).
  2. Type the following command and press Enter: 
    mwala
  3. If installed correctly, you’ll see a welcome message or command list.

Extra Tips

  • If mwala is not recognized:
    • Close and reopen your terminal.
    • Double-check that you added the correct path to the environment variable.
  • Make sure the mwalajs folder contains a file like mwala.mjs.
  • Ensure Node.js is installed properly.

Troubleshooting

Issue Solution
mwala is not recognized Recheck environment path, restart CMD
File won’t extract Install 7-Zip or WinRAR
Node.js not found Download from Node.js official site

LINUX INSTALLATION (Ubuntu / Debian / Fedora / Others)

Make sure Node.js is already installed on your system before you begin.
  1. Download MwalaJS:
  2. Open Terminal and go to the Downloads folder: 
    cd ~/Downloads
  3. Extract the downloaded file:
    • If ZIP: 
      unzip MwalaJS.zip
    • If TAR.GZ: 
      tar -xvzf MwalaJS.tar.gz
  4. Move the extracted folder to a system directory: 
    sudo mv mwalajs /opt/
  5. Make the main file executable (if it's a script): 
    sudo chmod +x /opt/mwalajs/mwala.mjs
  6. Create a system-wide shortcut (symlink): 
    sudo ln -s /opt/mwalajs/mwala.mjs /usr/local/bin/mwala
  7. Test the installation: 
    mwala

    If everything is set up correctly, you’ll see a welcome message or command list.

Troubleshooting

IssueSolution
mwala: command not found Check if the symlink is correct: ls -l /usr/local/bin/mwala
Node.js not installed Install Node.js using: 
sudo apt install nodejs npm
Permission denied Try using sudo or ensure the file has executable permission
MwalaJS Framework README

MwalaJS Framework

MwalaJS is a lightweight and modular JavaScript framework designed for building scalable server-side applications using modern Node.js features.

Installation

Install MwalaJS globally to use CLI tools:

npm install -g mwalajs

If you're using it in a specific project, install locally:

npm install mwalajs

Note: In case of errors regarding missing fs-extra, you can install it manually:

npm install -g fs-extra

Usage

Once installed globally, you can use the CLI command:

mwala

Or check the version:

mwala -v

🛠️ CLI Commands

Command Description
mwala create-project Create a new project using MwalaJS
mwala init initialization of mwalajs in the project
mwala serve Run the project in development mode
mwala help Display help instructions

🔐 Security Notes

  • Be sure to keep your dependencies updated.
  • Sanitize user inputs.
  • Run npm audit regularly.

License

MIT License © 2025 Hekima Mwala and MwalaJS Team

Reference Book: N/A

Author name: SIR H.A.Mwala Work email: biasharaboraofficials@gmail.com
#MWALA_LEARN Powered by MwalaJS #https://mwalajs.biasharabora.com
#https://educenter.biasharabora.com

:: 1.2::

⬅