MwalaJS Framework Documentation

Available Commands

mwala create-project <projectName>  ? Create a new MVC project.
mwala app.mjs                        ? Start the main application file.
Database Commands:
  - mwala create-db                      ? Create database.
  - mwala create-table <name>            ? Create a table.
  - mwala drop-table <name>              ? Drop a table.
  - mwala migrate all                    ? Run migrations.
  - mwala rollback all                  ? Undo last migration.

Code Generation:
  - mwala generate model <name>
  - mwala generate controller <name>
  - mwala generate route <name>
  - mwala generate view <name>
  - mwala generate midware <name>

mwala serve                         ? Start local server.
mwala help                          ? List all available commands.

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

Note 2: NOW MWALAJS IS ONE OF NPM PACKAGE NO NEED TO DOWNLOAD .ZIP, .RAR OR .EXE FILES
also no need to run mwala init in version 1.0.4 or above
before any create a .json file by running npm init make sure in your .json file you have "dependencies": { "mwalajs": "^1.0.5" } and "type": "module", these are more important to be set before run mwala serve , you can install it BY npm install -g mwalajs:

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
mwala serve Run the project in development mode
mwala help Display help instructions

?? Security Notes

License

MIT License © 2025 Hekima Mwala and MwalaJS Team

MwalaJS Release Downloads for all versions below version 1.0.2 download .exe,.zip or .rar in latest versions it is simply run npm install -g mwalajs and npm install mwalajs

Version 1.0.1

File Type Description Download
ZIP Latest release ZIP Download
RAR Latest release RAR Download

Version 1.0.0

File Type Description Download
EXE Installer (.exe) Download
ZIP v1.0.0 ZIP Download
RAR v1.0.0 RAR Download
Join the MwalaJS WhatsApp Support Group
Click here to join
MwalaJS Installation Guide

MwalaJS Installation Guide

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

What You’ll Need

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:
  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:
  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

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:
  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