Getting Started

Generate Module


This guide will help you to create Module in VaahCMS


  • Node
  • VaahCMS project directory

Step 1: VaahCli Installation

To use VaahCLI generators for generating modules, install VaahClI Tool using following command

npm i vaah -g

Step 2: Installation of Modules

Note: In this tutorial, we'll be creating Product Module.

Command that is used to generate a module is:-

npx vaah cms:m

After this command, it will ask for some information regarding the Module,answers are also mentioned here.

? Choose the tech stack of the module:  Module - Vue3 & PrimeVue
  • Name of The Module you want to create. For example Product.
    ? Enter your module name: Product
  • Title of the Module. For example Product Management.
    ? Enter meaningful title for your module: Product Management
  • Description about the Module. For example Product Management Module for Admin
    ? Enter your module description: Product Management Module for Admin
  • Name of the person creating the module or you can press enter to go with default value provided.
    ? Enter Author name: vaah
  • Email of the author or press enter to go with default value provided.
    ? Enter Author email:
  • Author website and download url or press enter for default value.
    ? Enter author website:
    ? Enter download url: 
  • Enter true if you want to run migration for this module as soon as the module is activated.
    ? Do you want to run migration on activation (true/false):  true
  • Enter true if you want to activate this module with some sample data. Use SampleDataTableSeeder for seeding Sample data.
    ? Will your module contains sample data (true/false):  true

After providing all the information, Module will be generated under project-root/Vaahcms/Modules.


<module-root-folder>\config\config.php contains the information that was entered while creating a module and can be changed by making changes to config.php file.


Step 3: Activating a module

To activate the module you need to visit the following url and login to the backend panel using your credentials that was created while the installation of VaahCMS.

backend-login After that,on the sidebar, click on `Extend` and then click on `Modules`.

List of all the installed modules will be displayed. From this list, find your module and click on Activate button present on the right side of that same module to activate the module. After Successful activation, module name will be visible on the sidebar.

Step 4: After activation of module, open .env & .env.custom and paste below code


Step 5: Install the dependencies

Run 'npm install' at VaahCms/Modules/Product/Vue folder
Now run 'npm run dev' at VaahCms/Modules/Product/Vue folder

Step 6: Go to following url to access dashboard of product


This video will help you to understand how to generate module.

Directory Structure of Module

          ├── .gitkeep
          ├── config.php     
            ├── Migrations
            ├── Seeds
        ├── Controllers
        ├── Middleware
        ├── Requests
             ├── .gitkeep
             ├── EventServiceProvider.php
             ├── ProductServiceProvider.php
             ├── RouteServiceProvider.php
             ├── assets/
             ├── lang/
             ├── views/
           ├── api.php
           ├── backend.php
           ├── frontend.php
        ├── components/
        ├── layouts/
        ├── node_modules/
        ├── pages/
        ├── routes/
        ├── stores/
        ├── vaahvue/
        ├── index.html
        ├── jsconfig.json
        ├── main.js
        ├── package.json
        ├── package-lock.json
        ├── vite.config.js
  • Config:

    Config file is present here. Config file contains all the information related to module, that was provided while creating module. And this information can be changed in this config file.module-config-file
  • Database: All the Factory, Migrations and Seeds files of this module are present in Database Folder.
  • Generate Migration File: To generate migration file you need to provide the module name and migration name. Migration file will be generated under Database/Migrations. In order to run migrations, deactivate and activate the module again.
     npx vaah cms:m-make migration <module-folder-name> <migration-name>
  • Generate Seeds File: To generate seeds file you need to provide the module name and seeder name. Seeds file will be generated under Database/Seeds or we can use json files to seed data into tables. To use a json file, create a json file under <module-folder>/Database/Seeds/json folder.
     npx vaah cms:m-make seed <module-folder-name> <seeder-name>
    To run SampleDataTableSeeder file, click on import sample data button.module-sample-seeder-button
  • Http: All the Controllers,Middlewares,Requests file related to this module will be created here. Command used to create controller is:-
        npx vaah cms:m-make controller <module-folder-name> <controller-name>
        npx vaah cms:m-make middleware <module-folder-name> <middleware-name>
  • Models: All the models for this module will be generated in <module-root>/Models.
     npx vaah cms:m-make model <module-root> <model-name>
  • Views: All the views for this module will be generated in <module-root>/Resources/Views/backend
    • this is the first page of the module index.blade.php.
  • Vue: This folder will contain all the vue files, vuex store, vue routes related to this module.
    • Vue components will be present under Vue/pages.module vue components files
    • Vue routes will be present under Vue/routes.modules vue routes file
    • Vue store will be present under Vue/stores.module vue store file

Copyright © 2024