mwalajs 1.0.6 → 1.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/views/index.ejs CHANGED
@@ -1,494 +1,499 @@
1
- <!DOCTYPE html>
2
- <html lang="en">
3
- <head>
4
- <meta charset="UTF-8" />
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0" />
6
- <title>MwalaJS Framework Documentation</title>
7
-
8
- <!-- Bootstrap -->
9
- <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
10
-
11
- <!-- Meta Info for SEO & Social Sharing -->
12
- <meta name="description" content="MwalaJS - Lightweight MVC JavaScript framework for full-stack web apps.">
13
- <meta name="keywords" content="MwalaJS, MVC, Node.js framework, JavaScript framework, documentation">
14
- <meta name="author" content="Hekima Ambalile Mwala">
15
-
16
- <!-- Open Graph (for social media cards) -->
17
- <meta property="og:title" content="MwalaJS - MVC Framework">
18
- <meta property="og:description" content="Documentation for MwalaJS framework including installation, commands, and structure.">
19
- <meta property="og:image" content="https://your-website-url.com/images/mwala-logo.png">
20
- <meta property="og:url" content="https://mwalajs.biasharabora.com">
21
-
22
- <!-- Twitter Cards -->
23
- <meta name="twitter:card" content="summary_large_image">
24
-
25
- <!-- Favicon -->
26
- <link rel="icon" href="favicon.ico" type="image/x-icon" />
27
-
28
- <!-- Custom Styles -->
29
- <style>
30
- body {
31
- background-color: #f8f9fa;
32
- font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
33
- line-height: 1.6;
34
- }
35
-
36
- h1, h2 {
37
- color: #0d6efd;
38
- }
39
-
40
- .help-content {
41
- background-color: #ffffff;
42
- padding: 2rem;
43
- border-radius: 8px;
44
- box-shadow: 0 4px 10px rgba(0, 0, 0, 0.05);
45
- margin-top: 2rem;
46
- }
47
-
48
- pre {
49
- background-color: #1e1e1e;
50
- color: #f1f1f1;
51
- padding: 1rem;
52
- border-radius: 8px;
53
- overflow-x: auto;
54
- }
55
-
56
- .nav-link {
57
- color: white !important;
58
- }
59
-
60
- .table thead {
61
- background-color: #f1f1f1;
62
- }
63
-
64
- footer {
65
- background-color: #212529;
66
- color: #ffffff;
67
- padding: 1rem 0;
68
- margin-top: 3rem;
69
- }
70
-
71
- .whatsapp-box {
72
- background-color: #d1e7dd;
73
- padding: 1rem;
74
- border-left: 5px solid #198754;
75
- border-radius: 6px;
76
- margin-top: 2rem;
77
- }
78
-
79
- .whatsapp-box a {
80
- color: #198754;
81
- font-weight: bold;
82
- }
83
-
84
- @media (max-width: 768px) {
85
- h1 {
86
- font-size: 1.5rem;
87
- }
88
-
89
- pre {
90
- font-size: 0.9rem;
91
- }
92
- }
93
- </style>
94
- </head>
95
- <body>
96
-
97
- <!-- Navigation -->
98
- <nav class="navbar navbar-expand-lg navbar-dark bg-dark">
99
- <div class="container">
100
- <a class="navbar-brand" href="#">MwalaJS</a>
101
- <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNav">
102
- <span class="navbar-toggler-icon"></span>
103
- </button>
104
- <div class="collapse navbar-collapse" id="navbarNav">
105
- <ul class="navbar-nav ms-auto">
106
- <li class="nav-item"><a class="nav-link" href="steps#overview">Overview</a></li>
107
- <li class="nav-item"><a class="nav-link" href="steps#installation">Installation</a></li>
108
- <li class="nav-item"><a class="nav-link" href="steps#commands">Commands</a></li>
109
- <li class="nav-item"><a class="nav-link" href="steps#structure">Structure</a></li>
110
- <li class="nav-item"><a class="nav-link" href="steps#example">Examples</a></li>
111
- <li class="nav-item"><a class="nav-link" href="/about">About</a></li>
112
- </ul>
113
- </div>
114
- </div>
115
- </nav>
116
-
117
- <!-- Main Content -->
118
- <div class="container">
119
- <h1 class="text-center my-4">MwalaJS Framework Documentation</h1>
120
-
121
- <div class="help-content">
122
- <h2>Available Commands</h2>
123
- <pre>
124
- <span class="command">mwala create-project &lt;projectName&gt;</span> ? Create a new MVC project.
125
- <span class="command">mwala app.mjs</span> ? Start the main application file.
126
- <span class="command">Database Commands:</span>
127
- - mwala create-db ? Create database.
128
- - mwala create-table &lt;name&gt; ? Create a table.
129
- - mwala drop-table &lt;name&gt; ? Drop a table.
130
- - mwala migrate all ? Run migrations.
131
- - mwala rollback all ? Undo last migration.
132
-
133
- <span class="command">Code Generation:</span>
134
- - mwala generate model &lt;name&gt;
135
- - mwala generate controller &lt;name&gt;
136
- - mwala generate route &lt;name&gt;
137
- - mwala generate view &lt;name&gt;
138
- - mwala generate midware &lt;name&gt;
139
-
140
- <span class="command">mwala serve</span> ? Start local server.
141
- <span class="command">mwala help</span> ? List all available commands.
142
- </pre>
143
- </div>
144
-
145
-
146
- <div class="container my-5">
147
- <h1 class="mb-4 text-primary">MwalaJS Framework</h1>
148
- <p><strong>MwalaJS</strong> is a lightweight and modular JavaScript framework designed for building scalable server-side applications using modern Node.js features.</p>
149
-
150
- <hr />
151
-
152
- <h2 class="mt-4">Installation </h2>
153
- <p>Install MwalaJS globally to use CLI tools:</p>
154
- <pre><code class=" p-3 rounded">npm install -g mwalajs</code></pre>
155
- <p>If you're using it in a specific project, install locally:</p>
156
- <pre><code class="p-3 rounded">npm install mwalajs</code></pre>
157
- <p><strong>Note:</strong> In case of errors regarding missing <code>fs-extra</code>, you can install it manually:</p>
158
- <pre><code class=" p-3 rounded">npm install -g fs-extra</code></pre>
159
- <p><strong>Note 2:</strong> <code class=" p-3 rounded"> NOW MWALAJS IS ONE OF NPM PACKAGE NO NEED TO DOWNLOAD .ZIP, .RAR OR .EXE FILES <br>
160
- also no need to run mwala init in version 1.0.4 or above
161
- <br>
162
- before any create a .json file by running npm init
163
- make sure in your .json file you have "dependencies": {
164
- "mwalajs": "^1.0.5"
165
- }
166
- and "type": "module", these are more important to be set before run mwala serve
167
- </code>, you can install it BY npm install -g mwalajs:</p>
168
-
169
- <hr />
170
-
171
- <h2 class="mt-4"> Usage</h2>
172
- <p>Once installed globally, you can use the CLI command:</p>
173
- <pre><code class=" p-3 rounded">mwala</code></pre>
174
- <p>Or check the version:</p>
175
- <pre><code class=" p-3 rounded">mwala -v</code></pre>
176
-
177
- <hr />
178
-
179
- <h2 class="mt-4">??? CLI Commands</h2>
180
- <table class="table table-bordered table-striped">
181
- <thead class="table-primary">
182
- <tr>
183
- <th>Command</th>
184
- <th>Description</th>
185
- </tr>
186
- </thead>
187
- <tbody>
188
- <tr>
189
- <td><code>mwala create-project</code></td>
190
- <td>Create a new project using MwalaJS</td>
191
- </tr>
192
- <tr>
193
- <td><code>npm init </code></td>
194
- <td>initialization of .json file in the project</td>
195
- </tr>
196
- <tr>
197
- <td><code>mwala serve</code></td>
198
- <td>Run the project in development mode</td>
199
- </tr>
200
- <tr>
201
- <td><code>mwala help</code></td>
202
- <td>Display help instructions</td>
203
- </tr>
204
- </tbody>
205
- </table>
206
-
207
- <hr />
208
-
209
- <h2 class="mt-4">?? Security Notes</h2>
210
- <ul>
211
- <li>Be sure to keep your dependencies updated.</li>
212
- <li>Sanitize user inputs.</li>
213
- <li>Run <code>npm audit</code> regularly.</li>
214
- </ul>
215
-
216
- <hr />
217
-
218
- <h2 class="mt-4"> License</h2>
219
- <p>MIT License © 2025 Hekima Mwala and MwalaJS Team</p>
220
- </div>
221
-
222
- <!-- Download Section -->
223
- <section class="mt-5">
224
- <h2 class="text-primary">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</h2>
225
-
226
- <div class="table-responsive">
227
- <h4 class="text-success">Version 1.0.1 </h4>
228
- <table class="table table-bordered table-hover">
229
- <thead>
230
- <tr>
231
- <th>File Type</th>
232
- <th>Description</th>
233
- <th>Download</th>
234
- </tr>
235
- </thead>
236
- <tbody>
237
- <tr>
238
- <td>ZIP</td>
239
- <td>Latest release ZIP</td>
240
- <td><a class="btn btn-primary btn-sm" href="https://mwalajs.biasharabora.com/files/mwalajsv101.zip">Download</a></td>
241
- </tr>
242
- <tr>
243
- <td>RAR</td>
244
- <td>Latest release RAR</td>
245
- <td><a class="btn btn-primary btn-sm" href="https://mwalajs.biasharabora.com/files/mwalajsv101.rar">Download</a></td>
246
- </tr>
247
- </tbody>
248
- </table>
249
-
250
- <h4 class="text-secondary mt-4">Version 1.0.0</h4>
251
- <table class="table table-bordered table-hover">
252
- <thead>
253
- <tr>
254
- <th>File Type</th>
255
- <th>Description</th>
256
- <th>Download</th>
257
- </tr>
258
- </thead>
259
- <tbody>
260
- <tr>
261
- <td>EXE</td>
262
- <td>Installer (.exe)</td>
263
- <td><a class="btn btn-success btn-sm" href="https://mwalajs.biasharabora.com/files/mwalaJS_installer.exe">Download</a></td>
264
- </tr>
265
- <tr>
266
- <td>ZIP</td>
267
- <td>v1.0.0 ZIP</td>
268
- <td><a class="btn btn-secondary btn-sm" href="https://mwalajs.biasharabora.com/files/mwalajsm.zip">Download</a></td>
269
- </tr>
270
- <tr>
271
- <td>RAR</td>
272
- <td>v1.0.0 RAR</td>
273
- <td><a class="btn btn-secondary btn-sm" href="https://mwalajs.biasharabora.com/files/mwalajsm.rar">Download</a></td>
274
- </tr>
275
- </tbody>
276
- </table>
277
- </div>
278
- </section>
279
-
280
- <!-- WhatsApp Support Box -->
281
- <div class="whatsapp-box">
282
- <h5>Join the MwalaJS WhatsApp Support Group</h5>
283
- <a href="https://chat.whatsapp.com/F8x1p8R1EhZ5b7RX7PO6dR?mode=r_t" target="_blank">Click here to join</a>
284
- </div>
285
- </div>
286
-
287
- <!DOCTYPE html>
288
- <html lang="en">
289
- <head>
290
- <meta charset="UTF-8">
291
- <meta name="viewport" content="width=device-width, initial-scale=1">
292
- <title>MwalaJS Installation Guide</title>
293
-
294
-
295
- </head>
296
- <body>
297
-
298
- <h1>MwalaJS Installation Guide</h1>
299
- <iframe width="560" height="315" src="https://www.youtube.com/embed/Zzj0WnvDET4?si=NsgUZDlF0uRuqe1P" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
300
- <p><strong>Version:</strong> Latest<br>
301
- <strong>Official Website:</strong> <a href="https://mwalajs.biasharabora.com" target="_blank">https://mwalajs.biasharabora.com</a></p>
302
-
303
- <h2> What You’ll Need</h2>
304
- <ul>
305
- <li>A computer (Windows preferred)</li>
306
- <li>Internet connection</li>
307
- <li>Basic computer knowledge (copy, paste, extracting files)</li>
308
- <li><a href="https://nodejs.org" target="_blank">Node.js installed</a></li>
309
- </ul>
310
-
311
- <h2> Step-by-Step Installation Instructions</h2>
312
-
313
- <h3>STEP 1: Download MwalaJS</h3>
314
- <ol>
315
- <li>Open your browser and go to: <a href="https://mwalajs.biasharabora.com" target="_blank">https://mwalajs.biasharabora.com</a></li>
316
- <li>Choose one of the files:
317
- <ul>
318
- <li><code>MwalaJS.zip</code></li>
319
- <li><code>MwalaJS.rar</code></li>
320
- </ul>
321
- </li>
322
- <li>Download and save it to your computer (usually goes to your <strong>Downloads</strong> folder).</li>
323
- </ol>
324
-
325
- <h3>STEP 2: Extract the Downloaded File</h3>
326
- <ol>
327
- <li>Go to your <strong>Downloads</strong> folder.</li>
328
- <li>Right-click on the downloaded file:
329
- <ul>
330
- <li>If ZIP ? choose <strong>Extract All</strong></li>
331
- <li>If RAR ? open with <strong>WinRAR</strong> or <strong>7-Zip</strong></li>
332
- </ul>
333
- </li>
334
- <li>You’ll get a folder named <code>mwalajs</code>. Copy or cut this folder.</li>
335
- </ol>
336
-
337
- <h3>STEP 3: Move to Program Files</h3>
338
- <ol>
339
- <li>Open <strong>C:\Program Files</strong> on your PC.</li>
340
- <li>Paste the <code>mwalajs</code> folder inside.</li>
341
- <li>If asked for administrator permission, click <strong>Continue</strong>.</li>
342
- </ol>
343
-
344
- <h3>STEP 4: Add to Environment Variable</h3>
345
- <div class="note">This step allows you to run <code>mwala</code> command from any terminal window.</div>
346
- <ol>
347
- <li>Press <strong>Windows + S</strong>, type <em>environment variables</em>, and click on <strong>Edit the system environment variables</strong>.</li>
348
- <li>In the new window, click <strong>Environment Variables</strong>.</li>
349
- <li>Under <strong>System variables</strong>, select <code>Path</code> and click <strong>Edit</strong>.</li>
350
- <li>Click <strong>New</strong>, then paste the path:
351
- <pre>C:\Program Files\mwalajs</pre>
352
- </li>
353
- <li>Click <strong>OK</strong> on all windows to save changes.</li>
354
- </ol>
355
-
356
- <h3>STEP 5: Test the Installation</h3>
357
- <ol>
358
- <li>Open <strong>Command Prompt</strong> (Windows + R ? type <code>cmd</code> ? Enter).</li>
359
- <li>Type the following command and press Enter:
360
- <pre>mwala</pre>
361
- </li>
362
- <li>If installed correctly, you’ll see a welcome message or command list.</li>
363
- </ol>
364
-
365
- <h2> Extra Tips</h2>
366
- <ul>
367
- <li>If <code>mwala</code> is not recognized:
368
- <ul>
369
- <li>Close and reopen your terminal.</li>
370
- <li>Double-check that you added the correct path to the environment variable.</li>
371
- </ul>
372
- </li>
373
- <li>Make sure the <code>mwalajs</code> folder contains a file like <code>mwala.mjs</code>.</li>
374
- <li>Ensure Node.js is installed properly.</li>
375
- </ul>
376
-
377
- <h2>Troubleshooting</h2>
378
- <table>
379
- <thead>
380
- <tr>
381
- <th>Issue</th>
382
- <th>Solution</th>
383
- </tr>
384
- </thead>
385
- <tbody>
386
- <tr>
387
- <td><code>mwala</code> is not recognized</td>
388
- <td>Recheck environment path, restart CMD</td>
389
- </tr>
390
- <tr>
391
- <td>File won’t extract</td>
392
- <td>Install <a href="https://www.7-zip.org" target="_blank">7-Zip</a> or <a href="https://www.rarlab.com" target="_blank">WinRAR</a></td>
393
- </tr>
394
- <tr>
395
- <td>Node.js not found</td>
396
- <td><a href="https://nodejs.org" target="_blank">Download from Node.js official site</a></td>
397
- </tr>
398
- </tbody>
399
- </table>
400
-
401
- <h3>LINUX INSTALLATION (Ubuntu / Debian / Fedora / Others)</h3>
402
-
403
- <div class="note">Make sure Node.js is already installed on your system before you begin.</div>
404
-
405
- <ol>
406
- <li><strong>Download MwalaJS:</strong>
407
- <ul>
408
- <li>Visit: <a href="https://mwalajs.biasharabora.com" target="_blank">https://mwalajs.biasharabora.com</a></li>
409
- <li>Select and download either:
410
- <ul>
411
- <li><code>MwalaJS.zip</code></li>
412
- <li><code>MwalaJS.tar.gz</code></li>
413
- </ul>
414
- </li>
415
- </ul>
416
- </li>
417
-
418
- <li><strong>Open Terminal and go to the Downloads folder:</strong>
419
- <pre>cd ~/Downloads</pre>
420
- </li>
421
-
422
- <li><strong>Extract the downloaded file:</strong>
423
- <ul>
424
- <li>If ZIP:
425
- <pre>unzip MwalaJS.zip</pre>
426
- </li>
427
- <li>If TAR.GZ:
428
- <pre>tar -xvzf MwalaJS.tar.gz</pre>
429
- </li>
430
- </ul>
431
- </li>
432
-
433
- <li><strong>Move the extracted folder to a system directory:</strong>
434
- <pre>sudo mv mwalajs /opt/</pre>
435
- </li>
436
-
437
- <li><strong>Make the main file executable (if it's a script):</strong>
438
- <pre>sudo chmod +x /opt/mwalajs/mwala.mjs</pre>
439
- </li>
440
-
441
- <li><strong>Create a system-wide shortcut (symlink):</strong>
442
- <pre>sudo ln -s /opt/mwalajs/mwala.mjs /usr/local/bin/mwala</pre>
443
- </li>
444
-
445
- <li><strong>Test the installation:</strong>
446
- <pre>mwala</pre>
447
- <p>If everything is set up correctly, you’ll see a welcome message or command list.</p>
448
- </li>
449
- </ol>
450
-
451
- <h4>Troubleshooting</h4>
452
- <table>
453
- <thead>
454
- <tr><th>Issue</th><th>Solution</th></tr>
455
- </thead>
456
- <tbody>
457
- <tr>
458
- <td><code>mwala: command not found</code></td>
459
- <td>Check if the symlink is correct: <code>ls -l /usr/local/bin/mwala</code></td>
460
- </tr>
461
- <tr>
462
- <td>Node.js not installed</td>
463
- <td>Install Node.js using:
464
- <pre>sudo apt install nodejs npm</pre>
465
- </td>
466
- </tr>
467
- <tr>
468
- <td>Permission denied</td>
469
- <td>Try using <code>sudo</code> or ensure the file has executable permission</td>
470
- </tr>
471
- </tbody>
472
- </table>
473
-
474
- <footer>
475
- <h3>Need Help?</h3>
476
- <p>Feel free to contact the developer or support:</p>
477
- <ul>
478
- <li>Email: <a href="mailto:biasharaboraofficials@biasharabora.com">biasharaboraofficials@biasharabora.com</a></li>
479
- <li>Website: <a href="https://mwalajs.biasharabora.com" target="_blank">https://mwalajs.biasharabora.com</a></li>
480
- </ul>
481
- </footer>
482
-
483
-
484
- <!-- Footer -->
485
- <footer class="text-center">
486
- <div class="container">
487
- &copy; 2025 MwalaJS Framework. Built by MwalaJS Development Team.
488
- </div>
489
- </footer>
490
-
491
- <!-- Bootstrap JS -->
492
- <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script>
493
- </body>
494
- </html>
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8" />
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
6
+ <title>MwalaJS Framework Documentation</title>
7
+
8
+ <!-- Bootstrap -->
9
+ <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
10
+
11
+ <!-- Meta Info for SEO & Social Sharing -->
12
+ <meta name="description" content="MwalaJS - Lightweight MVC JavaScript framework for full-stack web apps.">
13
+ <meta name="keywords" content="MwalaJS, MVC, Node.js framework, JavaScript framework, documentation">
14
+ <meta name="author" content="Hekima Ambalile Mwala">
15
+
16
+ <!-- Open Graph (for social media cards) -->
17
+ <meta property="og:title" content="MwalaJS - MVC Framework">
18
+ <meta property="og:description" content="Documentation for MwalaJS framework including installation, commands, and structure.">
19
+ <meta property="og:image" content="https://your-website-url.com/images/mwala-logo.png">
20
+ <meta property="og:url" content="https://mwalajs.biasharabora.com">
21
+
22
+ <!-- Twitter Cards -->
23
+ <meta name="twitter:card" content="summary_large_image">
24
+
25
+ <!-- Favicon -->
26
+ <link rel="icon" href="favicon.ico" type="image/x-icon" />
27
+
28
+ <!-- Custom Styles -->
29
+ <style>
30
+ body {
31
+ background-color: #f8f9fa;
32
+ font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
33
+ line-height: 1.6;
34
+ }
35
+
36
+ h1, h2 {
37
+ color: #0d6efd;
38
+ }
39
+
40
+ .help-content {
41
+ background-color: #ffffff;
42
+ padding: 2rem;
43
+ border-radius: 8px;
44
+ box-shadow: 0 4px 10px rgba(0, 0, 0, 0.05);
45
+ margin-top: 2rem;
46
+ }
47
+
48
+ pre {
49
+ background-color: #1e1e1e;
50
+ color: #f1f1f1;
51
+ padding: 1rem;
52
+ border-radius: 8px;
53
+ overflow-x: auto;
54
+ }
55
+
56
+ .nav-link {
57
+ color: white !important;
58
+ }
59
+
60
+ .table thead {
61
+ background-color: #f1f1f1;
62
+ }
63
+
64
+ footer {
65
+ background-color: #212529;
66
+ color: #ffffff;
67
+ padding: 1rem 0;
68
+ margin-top: 3rem;
69
+ }
70
+
71
+ .whatsapp-box {
72
+ background-color: #d1e7dd;
73
+ padding: 1rem;
74
+ border-left: 5px solid #198754;
75
+ border-radius: 6px;
76
+ margin-top: 2rem;
77
+ }
78
+
79
+ .whatsapp-box a {
80
+ color: #198754;
81
+ font-weight: bold;
82
+ }
83
+
84
+ @media (max-width: 768px) {
85
+ h1 {
86
+ font-size: 1.5rem;
87
+ }
88
+
89
+ pre {
90
+ font-size: 0.9rem;
91
+ }
92
+ }
93
+ </style>
94
+
95
+
96
+ <script type='text/javascript' src='//pl27404152.profitableratecpm.com/92/27/b0/9227b0cb1a79df89bd1c2f798cf8349a.js'></script>
97
+
98
+ </head>
99
+ <body>
100
+
101
+ <!-- Navigation -->
102
+ <nav class="navbar navbar-expand-lg navbar-dark bg-dark">
103
+ <div class="container">
104
+ <a class="navbar-brand" href="#">MwalaJS</a>
105
+ <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNav">
106
+ <span class="navbar-toggler-icon"></span>
107
+ </button>
108
+ <div class="collapse navbar-collapse" id="navbarNav">
109
+ <ul class="navbar-nav ms-auto">
110
+ <li class="nav-item"><a class="nav-link" href="steps#overview">Overview</a></li>
111
+ <li class="nav-item"><a class="nav-link" href="steps#installation">Installation</a></li>
112
+ <li class="nav-item"><a class="nav-link" href="steps#commands">Commands</a></li>
113
+ <li class="nav-item"><a class="nav-link" href="steps#structure">Structure</a></li>
114
+ <li class="nav-item"><a class="nav-link" href="steps#example">Examples</a></li>
115
+ <li class="nav-item"><a class="nav-link" href="/about">About</a></li>
116
+ </ul>
117
+ </div>
118
+ </div>
119
+ </nav>
120
+
121
+ <!-- Main Content -->
122
+ <div class="container">
123
+ <h1 class="text-center my-4">MwalaJS Framework Documentation</h1>
124
+
125
+ <div class="help-content">
126
+ <h2>Available Commands</h2>
127
+ <pre>
128
+ <span class="command">mwala create-project &lt;projectName&gt;</span> ? Create a new MVC project.
129
+ <span class="command">mwala app.mjs</span> ? Start the main application file.
130
+ <span class="command">Database Commands:</span>
131
+ - mwala create-db ? Create database.
132
+ - mwala create-table &lt;name&gt; ? Create a table.
133
+ - mwala drop-table &lt;name&gt; ? Drop a table.
134
+ - mwala migrate all ? Run migrations.
135
+ - mwala rollback all ? Undo last migration.
136
+
137
+ <span class="command">Code Generation:</span>
138
+ - mwala generate model &lt;name&gt;
139
+ - mwala generate controller &lt;name&gt;
140
+ - mwala generate route &lt;name&gt;
141
+ - mwala generate view &lt;name&gt;
142
+ - mwala generate midware &lt;name&gt;
143
+
144
+ <span class="command">mwala serve</span> ? Start local server.
145
+ <span class="command">mwala help</span> ? List all available commands.
146
+ </pre>
147
+ </div>
148
+ <script async="async" data-cfasync="false" src="//pl27404049.profitableratecpm.com/a933398713ec731f0673fbcacee9b154/invoke.js"></script>
149
+ <div id="container-a933398713ec731f0673fbcacee9b154"></div>
150
+
151
+ <div class="container my-5">
152
+ <h1 class="mb-4 text-primary">MwalaJS Framework</h1>
153
+ <p><strong>MwalaJS</strong> is a lightweight and modular JavaScript framework designed for building scalable server-side applications using modern Node.js features.</p>
154
+
155
+ <hr />
156
+
157
+ <h2 class="mt-4">Installation </h2>
158
+ <p>Install MwalaJS globally to use CLI tools:</p>
159
+ <pre><code class=" p-3 rounded">npm install -g mwalajs</code></pre>
160
+ <p>If you're using it in a specific project, install locally:</p>
161
+ <pre><code class="p-3 rounded">npm install mwalajs</code></pre>
162
+ <p><strong>Note:</strong> In case of errors regarding missing <code>fs-extra</code>, you can install it manually:</p>
163
+ <pre><code class=" p-3 rounded">npm install -g fs-extra</code></pre>
164
+ <p><strong>Note 2:</strong> <code class=" p-3 rounded"> NOW MWALAJS IS ONE OF NPM PACKAGE NO NEED TO DOWNLOAD .ZIP, .RAR OR .EXE FILES <br>
165
+ also no need to run mwala init in version 1.0.4 or above
166
+ <br>
167
+ before any create a .json file by running npm init
168
+ make sure in your .json file you have "dependencies": {
169
+ "mwalajs": "^1.0.5"
170
+ }
171
+ and "type": "module", these are more important to be set before run mwala serve
172
+ </code>, you can install it BY npm install -g mwalajs:</p>
173
+
174
+ <hr />
175
+
176
+ <h2 class="mt-4"> Usage</h2>
177
+ <p>Once installed globally, you can use the CLI command:</p>
178
+ <pre><code class=" p-3 rounded">mwala</code></pre>
179
+ <p>Or check the version:</p>
180
+ <pre><code class=" p-3 rounded">mwala -v</code></pre>
181
+
182
+ <hr />
183
+
184
+ <h2 class="mt-4">??? CLI Commands</h2>
185
+ <table class="table table-bordered table-striped">
186
+ <thead class="table-primary">
187
+ <tr>
188
+ <th>Command</th>
189
+ <th>Description</th>
190
+ </tr>
191
+ </thead>
192
+ <tbody>
193
+ <tr>
194
+ <td><code>mwala create-project</code></td>
195
+ <td>Create a new project using MwalaJS</td>
196
+ </tr>
197
+ <tr>
198
+ <td><code>mwala init </code></td>
199
+ <td>initialization of mwalajs </td>
200
+ </tr>
201
+ <tr>
202
+ <td><code>mwala serve</code></td>
203
+ <td>Run the project in development mode</td>
204
+ </tr>
205
+ <tr>
206
+ <td><code>mwala help</code></td>
207
+ <td>Display help instructions</td>
208
+ </tr>
209
+ </tbody>
210
+ </table>
211
+
212
+ <hr />
213
+
214
+ <h2 class="mt-4">?? Security Notes</h2>
215
+ <ul>
216
+ <li>Be sure to keep your dependencies updated.</li>
217
+ <li>Sanitize user inputs.</li>
218
+ <li>Run <code>npm audit</code> regularly.</li>
219
+ </ul>
220
+
221
+ <hr />
222
+
223
+ <h2 class="mt-4"> License</h2>
224
+ <p>MIT License © 2025 Hekima Mwala and MwalaJS Team</p>
225
+ </div>
226
+
227
+ <!-- Download Section -->
228
+ <section class="mt-5">
229
+ <h2 class="text-primary">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</h2>
230
+
231
+ <div class="table-responsive">
232
+ <h4 class="text-success">Version 1.0.1 </h4>
233
+ <table class="table table-bordered table-hover">
234
+ <thead>
235
+ <tr>
236
+ <th>File Type</th>
237
+ <th>Description</th>
238
+ <th>Download</th>
239
+ </tr>
240
+ </thead>
241
+ <tbody>
242
+ <tr>
243
+ <td>ZIP</td>
244
+ <td>Latest release ZIP</td>
245
+ <td><a class="btn btn-primary btn-sm" href="https://mwalajs.biasharabora.com/files/mwalajsv101.zip">Download</a></td>
246
+ </tr>
247
+ <tr>
248
+ <td>RAR</td>
249
+ <td>Latest release RAR</td>
250
+ <td><a class="btn btn-primary btn-sm" href="https://mwalajs.biasharabora.com/files/mwalajsv101.rar">Download</a></td>
251
+ </tr>
252
+ </tbody>
253
+ </table>
254
+
255
+ <h4 class="text-secondary mt-4">Version 1.0.0</h4>
256
+ <table class="table table-bordered table-hover">
257
+ <thead>
258
+ <tr>
259
+ <th>File Type</th>
260
+ <th>Description</th>
261
+ <th>Download</th>
262
+ </tr>
263
+ </thead>
264
+ <tbody>
265
+ <tr>
266
+ <td>EXE</td>
267
+ <td>Installer (.exe)</td>
268
+ <td><a class="btn btn-success btn-sm" href="https://mwalajs.biasharabora.com/files/mwalaJS_installer.exe">Download</a></td>
269
+ </tr>
270
+ <tr>
271
+ <td>ZIP</td>
272
+ <td>v1.0.0 ZIP</td>
273
+ <td><a class="btn btn-secondary btn-sm" href="https://mwalajs.biasharabora.com/files/mwalajsm.zip">Download</a></td>
274
+ </tr>
275
+ <tr>
276
+ <td>RAR</td>
277
+ <td>v1.0.0 RAR</td>
278
+ <td><a class="btn btn-secondary btn-sm" href="https://mwalajs.biasharabora.com/files/mwalajsm.rar">Download</a></td>
279
+ </tr>
280
+ </tbody>
281
+ </table>
282
+ </div>
283
+ </section>
284
+
285
+ <!-- WhatsApp Support Box -->
286
+ <div class="whatsapp-box">
287
+ <h5>Join the MwalaJS WhatsApp Support Group</h5>
288
+ <a href="https://chat.whatsapp.com/F8x1p8R1EhZ5b7RX7PO6dR?mode=r_t" target="_blank">Click here to join</a>
289
+ </div>
290
+ </div>
291
+
292
+ <!DOCTYPE html>
293
+ <html lang="en">
294
+ <head>
295
+ <meta charset="UTF-8">
296
+ <meta name="viewport" content="width=device-width, initial-scale=1">
297
+ <title>MwalaJS Installation Guide</title>
298
+
299
+
300
+ </head>
301
+ <body>
302
+
303
+ <h1>MwalaJS Installation Guide</h1>
304
+ <iframe width="560" height="315" src="https://www.youtube.com/embed/Zzj0WnvDET4?si=NsgUZDlF0uRuqe1P" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
305
+ <p><strong>Version:</strong> Latest<br>
306
+ <strong>Official Website:</strong> <a href="https://mwalajs.biasharabora.com" target="_blank">https://mwalajs.biasharabora.com</a></p>
307
+
308
+ <h2> What You’ll Need</h2>
309
+ <ul>
310
+ <li>A computer (Windows preferred)</li>
311
+ <li>Internet connection</li>
312
+ <li>Basic computer knowledge (copy, paste, extracting files)</li>
313
+ <li><a href="https://nodejs.org" target="_blank">Node.js installed</a></li>
314
+ </ul>
315
+
316
+ <h2> Step-by-Step Installation Instructions</h2>
317
+
318
+ <h3>STEP 1: Download MwalaJS</h3>
319
+ <ol>
320
+ <li>Open your browser and go to: <a href="https://mwalajs.biasharabora.com" target="_blank">https://mwalajs.biasharabora.com</a></li>
321
+ <li>Choose one of the files:
322
+ <ul>
323
+ <li><code>MwalaJS.zip</code></li>
324
+ <li><code>MwalaJS.rar</code></li>
325
+ </ul>
326
+ </li>
327
+ <li>Download and save it to your computer (usually goes to your <strong>Downloads</strong> folder).</li>
328
+ </ol>
329
+
330
+ <h3>STEP 2: Extract the Downloaded File</h3>
331
+ <ol>
332
+ <li>Go to your <strong>Downloads</strong> folder.</li>
333
+ <li>Right-click on the downloaded file:
334
+ <ul>
335
+ <li>If ZIP ? choose <strong>Extract All</strong></li>
336
+ <li>If RAR ? open with <strong>WinRAR</strong> or <strong>7-Zip</strong></li>
337
+ </ul>
338
+ </li>
339
+ <li>You’ll get a folder named <code>mwalajs</code>. Copy or cut this folder.</li>
340
+ </ol>
341
+
342
+ <h3>STEP 3: Move to Program Files</h3>
343
+ <ol>
344
+ <li>Open <strong>C:\Program Files</strong> on your PC.</li>
345
+ <li>Paste the <code>mwalajs</code> folder inside.</li>
346
+ <li>If asked for administrator permission, click <strong>Continue</strong>.</li>
347
+ </ol>
348
+
349
+ <h3>STEP 4: Add to Environment Variable</h3>
350
+ <div class="note">This step allows you to run <code>mwala</code> command from any terminal window.</div>
351
+ <ol>
352
+ <li>Press <strong>Windows + S</strong>, type <em>environment variables</em>, and click on <strong>Edit the system environment variables</strong>.</li>
353
+ <li>In the new window, click <strong>Environment Variables</strong>.</li>
354
+ <li>Under <strong>System variables</strong>, select <code>Path</code> and click <strong>Edit</strong>.</li>
355
+ <li>Click <strong>New</strong>, then paste the path:
356
+ <pre>C:\Program Files\mwalajs</pre>
357
+ </li>
358
+ <li>Click <strong>OK</strong> on all windows to save changes.</li>
359
+ </ol>
360
+
361
+ <h3>STEP 5: Test the Installation</h3>
362
+ <ol>
363
+ <li>Open <strong>Command Prompt</strong> (Windows + R ? type <code>cmd</code> ? Enter).</li>
364
+ <li>Type the following command and press Enter:
365
+ <pre>mwala</pre>
366
+ </li>
367
+ <li>If installed correctly, you’ll see a welcome message or command list.</li>
368
+ </ol>
369
+
370
+ <h2> Extra Tips</h2>
371
+ <ul>
372
+ <li>If <code>mwala</code> is not recognized:
373
+ <ul>
374
+ <li>Close and reopen your terminal.</li>
375
+ <li>Double-check that you added the correct path to the environment variable.</li>
376
+ </ul>
377
+ </li>
378
+ <li>Make sure the <code>mwalajs</code> folder contains a file like <code>mwala.mjs</code>.</li>
379
+ <li>Ensure Node.js is installed properly.</li>
380
+ </ul>
381
+
382
+ <h2>Troubleshooting</h2>
383
+ <table>
384
+ <thead>
385
+ <tr>
386
+ <th>Issue</th>
387
+ <th>Solution</th>
388
+ </tr>
389
+ </thead>
390
+ <tbody>
391
+ <tr>
392
+ <td><code>mwala</code> is not recognized</td>
393
+ <td>Recheck environment path, restart CMD</td>
394
+ </tr>
395
+ <tr>
396
+ <td>File won’t extract</td>
397
+ <td>Install <a href="https://www.7-zip.org" target="_blank">7-Zip</a> or <a href="https://www.rarlab.com" target="_blank">WinRAR</a></td>
398
+ </tr>
399
+ <tr>
400
+ <td>Node.js not found</td>
401
+ <td><a href="https://nodejs.org" target="_blank">Download from Node.js official site</a></td>
402
+ </tr>
403
+ </tbody>
404
+ </table>
405
+
406
+ <h3>LINUX INSTALLATION (Ubuntu / Debian / Fedora / Others)</h3>
407
+
408
+ <div class="note">Make sure Node.js is already installed on your system before you begin.</div>
409
+
410
+ <ol>
411
+ <li><strong>Download MwalaJS:</strong>
412
+ <ul>
413
+ <li>Visit: <a href="https://mwalajs.biasharabora.com" target="_blank">https://mwalajs.biasharabora.com</a></li>
414
+ <li>Select and download either:
415
+ <ul>
416
+ <li><code>MwalaJS.zip</code></li>
417
+ <li><code>MwalaJS.tar.gz</code></li>
418
+ </ul>
419
+ </li>
420
+ </ul>
421
+ </li>
422
+
423
+ <li><strong>Open Terminal and go to the Downloads folder:</strong>
424
+ <pre>cd ~/Downloads</pre>
425
+ </li>
426
+
427
+ <li><strong>Extract the downloaded file:</strong>
428
+ <ul>
429
+ <li>If ZIP:
430
+ <pre>unzip MwalaJS.zip</pre>
431
+ </li>
432
+ <li>If TAR.GZ:
433
+ <pre>tar -xvzf MwalaJS.tar.gz</pre>
434
+ </li>
435
+ </ul>
436
+ </li>
437
+
438
+ <li><strong>Move the extracted folder to a system directory:</strong>
439
+ <pre>sudo mv mwalajs /opt/</pre>
440
+ </li>
441
+
442
+ <li><strong>Make the main file executable (if it's a script):</strong>
443
+ <pre>sudo chmod +x /opt/mwalajs/mwala.mjs</pre>
444
+ </li>
445
+
446
+ <li><strong>Create a system-wide shortcut (symlink):</strong>
447
+ <pre>sudo ln -s /opt/mwalajs/mwala.mjs /usr/local/bin/mwala</pre>
448
+ </li>
449
+
450
+ <li><strong>Test the installation:</strong>
451
+ <pre>mwala</pre>
452
+ <p>If everything is set up correctly, you’ll see a welcome message or command list.</p>
453
+ </li>
454
+ </ol>
455
+
456
+ <h4>Troubleshooting</h4>
457
+ <table>
458
+ <thead>
459
+ <tr><th>Issue</th><th>Solution</th></tr>
460
+ </thead>
461
+ <tbody>
462
+ <tr>
463
+ <td><code>mwala: command not found</code></td>
464
+ <td>Check if the symlink is correct: <code>ls -l /usr/local/bin/mwala</code></td>
465
+ </tr>
466
+ <tr>
467
+ <td>Node.js not installed</td>
468
+ <td>Install Node.js using:
469
+ <pre>sudo apt install nodejs npm</pre>
470
+ </td>
471
+ </tr>
472
+ <tr>
473
+ <td>Permission denied</td>
474
+ <td>Try using <code>sudo</code> or ensure the file has executable permission</td>
475
+ </tr>
476
+ </tbody>
477
+ </table>
478
+
479
+ <footer>
480
+ <h3>Need Help?</h3>
481
+ <p>Feel free to contact the developer or support:</p>
482
+ <ul>
483
+ <li>Email: <a href="mailto:biasharaboraofficials@biasharabora.com">biasharaboraofficials@biasharabora.com</a></li>
484
+ <li>Website: <a href="https://mwalajs.biasharabora.com" target="_blank">https://mwalajs.biasharabora.com</a></li>
485
+ </ul>
486
+ </footer>
487
+
488
+
489
+ <!-- Footer -->
490
+ <footer class="text-center">
491
+ <div class="container">
492
+ &copy; 2025 MwalaJS Framework. Built by MwalaJS Development Team.
493
+ </div>
494
+ </footer>
495
+
496
+ <!-- Bootstrap JS -->
497
+ <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script>
498
+ </body>
499
+ </html>