1. What Is MwalaJS?

MwalaJS is a lightweight, high-performance Node.js framework built atop Express and optimized with the Google V8 engine. It follows the MVC architecture (Models, Views, Controllers) and includes CLI tooling for rapid project scaffolding.

More at: Official MwalaJS Site

2. Installation

Install globally:

npm install -g mwalajs

Or install in your project:

npm install mwalajs

3. CLI Commands & Usage

• mwala create-project project_name – create a new MwalaJS project
• mwala serve – start the development server
• mwala init – initialize framework files
• Database commands:
  • mwala create-db
  • mwala create-table <table_name>
  • mwala drop-table <table_name>
  • mwala migrate all
  • mwala rollback all
• Code generation:
  • mwala generate model <name>
  • mwala generate controller <name>
  • mwala generate route <name>
  • mwala generate view <name>
  • mwala generate midware <name>
• mwala help or mwala --version – list commands or version

4. Default Project Structure

project_name/
├── controllers/
├── models/
├── views/
├── routes/
├── public/
├── config/
└── app.mjs   (entry point)

You edit your Node.js code mainly in app.mjs which initializes the MVC structure.

5. Sample Application Code

app.mjs

import mwalajs from 'mwalajs';
import { homeRoutes } from './routes/homeRoutes.mjs';
import path from 'path';
import { fileURLToPath } from 'url';

const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);

mwalajs.set('view engine', 'ejs');
mwalajs.set('views', path.join(__dirname, 'views'));
mwalajs.useStatic(path.join(__dirname, 'public'));

mwalajs.use('/', homeRoutes);

const port = process.env.PORT || 3000;
mwalajs.listen(port, () => {
  console.log(`Server running at http://localhost:${port}`);
});

routes/homeRoutes.mjs

import mwalajs from 'mwalajs';
import { homeController, Steps, welcome, about } from '../controllers/homeController.mjs';

const router = mwalajs.Router();

router.get('/', homeController.getHomePage);
router.get('/steps', Steps.getSteps);
router.get('/welcome', welcome.getwelcome);
router.get('/about', about.getabout);

export { router as homeRoutes };

controllers/homeController.mjs

export const homeController = {
  getHomePage: (req,res) => res.render('index',{ title:'Welcome to MwalaJS MVC'})
};

export const Steps = {
  getSteps: (req,res) => res.render('steps',{ title:'Steps in MwalaJS MVC'})
};

export const welcome = {
  getwelcome: (req,res) => res.render('welcome',{ title:'Welcome to MwalaJS MVC'})
};

export const about = {
  getabout: (req,res) => res.render('about',{ title:'About MwalaJS MVC'})
};

6. Concept: MVC Architecture in MwalaJS

• Models – data access and DB operations
• Views – usually EJS templates for UI
• Controllers – business logic handlers
• Routers – route definitions linked to controllers

7. Summary Table

8. Getting Started

1. Open terminal, install MwalaJS globally or locally.
2. Run: mwala create-project myApp
3. Navigate into your project folder and run: mwala serve
4. Add controllers, routes, and views via mwala generate <type>
5. Set up migrations and run mwala migrate all

9. Resources

• Official MwalaJS Documentation
• MwalaJS MVC Format Guide (Scribd)