mwalajs 1.0.5 → 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,227 +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 of the page for search engines -->
7
- <title>MwalaJS</title>
8
-
9
- <!-- Meta description for better SEO ranking -->
10
- <meta name="description" content="Get detailed help and documentation for MwalaJS framework. Learn how to use MwalaJS commands, structure, installation, and more.">
11
-
12
- <!-- Meta keywords for SEO -->
13
- <meta name="keywords" content="MwalaJS, MVC framework, MwalaJS installation, MwalaJS commands, MwalaJS documentation, web development framework, JavaScript framework, full-stack development">
14
-
15
- <!-- Author information -->
16
- <meta name="author" content="Hekima Ambalile Mwala">
17
-
18
- <!-- Open Graph meta tags for social media optimization -->
19
- <meta property="og:title" content="MwalaJS - Help | Documentation for MVC Framework">
20
- <meta property="og:description" content="Get detailed help and documentation for MwalaJS framework. Learn how to use MwalaJS commands, structure, installation, and more.">
21
- <meta property="og:image" content="path-to-image.jpg"> <!-- Add your image URL for social media previews -->
22
- <meta property="og:url" content="https://yourwebsite.com/help"> <!-- Add your actual website URL here -->
23
-
24
- <!-- Twitter meta tags for better visibility on Twitter -->
25
- <meta name="twitter:title" content="MwalaJS - Help | Documentation for MVC Framework">
26
- <meta name="twitter:description" content="Get detailed help and documentation for MwalaJS framework. Learn how to use MwalaJS commands, structure, installation, and more.">
27
- <meta name="twitter:image" content="path-to-image.jpg">
28
- <meta name="twitter:card" content="summary_large_image">
29
- <meta property="og:url" content="https://mwalajs.biasharabora.com">
30
- <meta property="og:image" content="https://your-website-url.com/images/mwala-logo.png">
31
- <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0-alpha1/dist/css/bootstrap.min.css" rel="stylesheet">
32
-
33
- <!-- Favicon for the website -->
34
- <link rel="icon" href="favicon.ico" type="image/x-icon">
35
-
36
- <!-- Link to external stylesheet -->
37
- <link rel="stylesheet" href="styles.css">
38
-
39
-
40
- <style>
41
-
42
-
43
- body {
44
- font-family: Arial, sans-serif;
45
- margin: 0;
46
- padding: 0;
47
- background-color: #f4f4f4;
48
- }
49
-
50
- h1 {
51
- text-align: center;
52
- color: #333;
53
- }
54
-
55
- .container {
56
- max-width: 1200px;
57
- margin: 0 auto;
58
- padding: 20px;
59
- }
60
-
61
- .help-content {
62
- background-color: #fff;
63
- padding: 20px;
64
- border-radius: 8px;
65
- box-shadow: 0 2px 10px rgba(0, 0, 0, 0.1);
66
- }
67
-
68
- pre {
69
- background-color: #2d2d2d;
70
- color: #f4f4f4;
71
- padding: 20px;
72
- border-radius: 8px;
73
- white-space: pre-wrap;
74
- word-wrap: break-word;
75
- }
76
-
77
- .command {
78
- font-weight: bold;
79
- color: #5c5c5c;
80
- }
81
-
82
- @media (max-width: 768px) {
83
- body {
84
- font-size: 14px;
85
- }
86
-
87
- .container {
88
- padding: 10px;
89
- }
90
-
91
- pre {
92
- padding: 15px;
93
- }
94
-
95
- h1 {
96
- font-size: 1.5em;
97
- }
98
- }
99
-
100
- @media (max-width: 480px) {
101
- h1 {
102
- font-size: 1.2em;
103
- }
104
-
105
- pre {
106
- padding: 10px;
107
- }
108
- }
109
- </style>
110
- <link rel="stylesheet" href="styles.css">
111
- <!-- Structured data for better search engine understanding (JSON-LD) -->
112
- <script type="application/ld+json">
113
- {
114
- "@context": "https://schema.org",
115
- "@type": "WebPage",
116
- "name": "MwalaJS Help Documentation",
117
- "description": "Get detailed help and documentation for MwalaJS framework. Learn how to use MwalaJS commands, structure, installation, and more.",
118
- "url": "https://mwalajs.biasharabora.com/setups",
119
- "publisher": {
120
- "@type": "Organization",
121
- "name": "MwalaJS"
122
- }
123
- }
124
- </script>
125
-
126
- </head>
127
- <body>
128
- <!-- Navbar for easy navigation -->
129
- <nav class="navbar navbar-expand-lg navbar-dark bg-dark">
130
- <div class="container-fluid">
131
- <a class="navbar-brand" href="/">MwalaJS</a>
132
- <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNav" aria-controls="navbarNav" aria-expanded="false" aria-label="Toggle navigation">
133
- <span class="navbar-toggler-icon"></span>
134
- </button>
135
- <div class="collapse navbar-collapse" id="navbarNav">
136
- <ul class="navbar-nav">
137
- <li class="nav-item">
138
- <a class="nav-link active" href="steps#overview">Overview</a>
139
- </li>
140
- <li class="nav-item">
141
- <a class="nav-link" href="steps#installation">Installation</a>
142
- </li>
143
- <li class="nav-item">
144
- <a class="nav-link" href="steps#commands">Commands</a>
145
- </li>
146
- <li class="nav-item">
147
- <a class="nav-link" href="steps#structure">Project Structure</a>
148
- </li>
149
- <li class="nav-item">
150
- <a class="nav-link" href="steps#example">Example Application</a>
151
- </li>
152
- <li class="nav-item">
153
- <a class="nav-link" href="steps#conclusion">Conclusion</a>
154
- </li>
155
- </ul>
156
- </div>
157
- </div>
158
- </nav>
159
-
160
- <div class="container">
161
- <h1>MwalaJS Framework Help</h1>
162
- <div class="help-content">
163
- <p>Available commands for MwalaJS framework:</p>
164
- <pre>
165
- . <span class="command">mwala create-project &lt;&gt;</span> - Create a new MVC project. Example: mwala create myapp
166
- . <span class="command">mwala app.mjs</span> - Run the app.mjs file to start your application.
167
- . <span class="command">Database Operations:&gt;</span> - Database commands for various database tasks:
168
- - mwala create-db → Create the database specified in the .env file.
169
- - mwala create-table <name> → Create a specific database table.
170
- - mwala drop-table <name> → Drop a specific database table.
171
- - mwala migrate all → Run all pending migrations.
172
- - mwala rollback all →to undo migration
173
- 4. <span class="command">mwala generate &lt;model/controller/route/view&gt; &lt;name&gt;</span> - Generate various MVC components (models, controllers, routes, and views).
174
- Code Generation:
175
- - mwala generate model <name> → Create a new model.
176
- - mwala generate controller <name> → Create a new controller.
177
- - mwala generate route <name> → Create a new route.
178
- - mwala generate view <name> → Create a new view file.
179
- - mwala generate midware <name> Create a new middleware.
180
- . <span class="command">mwala serve</span> - Start the server (similar to running "mwala app.mjs" or "node app.mjs").
181
- . <span class="command">mwala help</span> - Show available commands (this command).
182
- . <span class="command">mwala create-table &lt;table_name&gt;</span> - Create a table in the database. Example: mwala create-table users
183
- . <span class="command">mwala drop-table &lt;table_name&gt;</span> - Drop a table from the database. Example: mwala drop-table users
184
- . <span class="command">mwala migrate all</span> - Run migrations on the database. Example: mwala migrate
185
- . <span class="command">mwala rollback all</span> - Rollback the last migration. Example: mwala rollback
186
- </pre>
187
-
188
- <section id="release">
189
- <br> <h2 class="section-title">1. VERSION RELEASE</h2>
190
- <p>Click below to download the installer For Mwalajs framework:</p>
191
- <br><a class="btn" href="https://mwalajs.biasharabora.com/files/mwalaJS_installer.exe" download>Download MwalaJS COMMAND SHELL (CLS) download .exe file here </a>
192
- <br> <p>Click below to download zip file mwalajs framework:</p>
193
- <br> <a class="btn" href="https://mwalajs.biasharabora.com/files/mwalajsm.zip" download>Download MwalaJS mwalajs.zip v1.0.0</a>
194
- <br> <p>Click below to download rar file mwalajs framework :</p>
195
- <br> <a class="btn" href="https://mwalajs.biasharabora.com/files/mwalajsm.rar" download>Download MwalaJS mwalajs.rar v1.0.0</a>
196
-
197
- <br>
198
-
199
- </section>
200
-
201
- </div>
202
- </div>
203
- <ul >
204
- <li c>
205
- <a class="link active" href="/welcome">MWALAJS FRAMEWORK OVERVIEW</a>
206
- </li>
207
- <li >
208
- <a href="/steps">steps to get started</a>
209
- </li>
210
- <li class="nav-item">
211
- <a href="steps#commands">Commands</a>
212
- </li>
213
- <li class="nav-item">
214
- <a href="steps#structure">Project Structure</a>
215
- </li>
216
- <li class="nav-item">
217
- <a href="steps#example">Example Application</a>
218
- </li>
219
- <li class="nav-item">
220
- <a href="/about">about</a>
221
- </li>
222
- </ul>
223
- </body>
224
- </html>
225
-
226
-
227
-
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>