Nodeschool Public Materials

    @mendix/generator-widget

    8.9.0 • Public • Published

    Pluggable Widgets Generator

    npm version Mendix 8 Build Status npm GitHub release GitHub issues

    Yeoman generator for Mendix Pluggable Widgets.

    About

    This generator uses the Yeoman scaffolding tool to let you quickly create a Mendix Pluggable Widget.


    Installation

    First, install Yeoman and @mendix/widget using npm (we assume you have pre-installed node.js).

    npm install -g yo
    npm install -g @mendix/generator-widget

    Then generate your new project inside an empty folder:

    yo @mendix/widget

    or automatically create the folder using:

    yo @mendix/widget widget name

    Scaffold a widget

    1. Provide the following information about your widget:

    The following information needs to be provided about your widget:

    • name
    • description
    • organization
    • copyright
    • license
    • version
    • author
    • Mendix Project path
    • programming language
    • platform

    Press if you want to skip and use default values.

    2.1. Using the task runner

    The widget generator will include the necessary files and tasks to your package.json for running the tasks over The Pluggable Widgets Tools.

    If necessary you can run the tasks using the commands

    npm start
    npm run build
    npm run release

    For more informations, visit our Mendix Pluggable Widget Tools repository

    2.2. Which template do you want to use for the widget?

    Full Boilerplate

    The full widget boiler plate is a React fully developed and tested Mendix widget that shows a value as a badge or a color label (just available for web/responsive platform). It has the following features:-

    • Display as a badge or a color label
    • Attach actions to onClick event
    • Set static data text when the dynamic data is not specified

    Empty widget

    The empty template is a Mendix React hello world widget recommended for more experienced developers.

    2.3 Add unit tests for the widget ?

    If Yes is selected, unit tests are included to ensure individual units of the component are tested to determine whether they are fit for use. Default value is No.

    2.4 Add end to end tests for the widget ?

    If Yes is selected, end to end tests are included to ensure that the integrated components of an application function as expected. Default value is No.

    Note: Both Unit and End to end tests apply only to the Full Boilerplate. End to End is exclusive for web and hybrid mobile apps.

    The tool will then create Copied files, and run npm install to install development dependencies.

    NOTE

    To use the webpack-dev-server while in your development;

    • start the Mendix Studio Pro from your Mendix project path or by default /dist/MxTestProject. then run:
    npm start
    • If you are running the generator through many OS (Using parallels or any other virtualization software), make sure you have the right privileges and use the same OS for generation and files manipulation.

    Issues

    Issues can be reported on Github.

    Install

    npm i @mendix/[email protected]

    Version

    8.9.0

    License

    Apache-2.0

    Unpacked Size

    118 kB

    Total Files

    111

    Last publish

    Collaborators

    • mx-jj
    • gauravshah
    • viprasharma
    • mx-aasthasharma
    • rishikeshjaadhav
    • mx-bhaktideshpande
    • kevinvl
    • stmarkidis
    • yhn
    • matthijssmmendix
    • jef-hellemans
    • mendix-webmodeler
    • mikhaila
    • jeltemx
    • mendix-webui
    • ebrpol
    • remcovh
    • jhuiting
    • ablok
    • ivanzub
    • bvanreeven
    • joeri
    • johandenhaan
    • tmi
    • anna.vyakhireva
    • modeler
    • ahmed.negm
    • bno-mendix
    • seanius
    • roland-mendix
    • roelandsalij
    • guidojo
    • brtn
    • lmeijvogel
    • erik.van.de.pol
    • manpreet185
    • r0b1n
    • afyzendo
    • tamelbrun
    • hasanas
    • takumagottschewski
    • mendix-ronaldlokers
    • rickymx
    • corina.zaharia
    • isa.isaku.mendix
    • mx-juan
    • aengelse
    • omxnajjar
    • cenkiravul
    • juliana-mx
    • govorov
    • diego.antonelli.mendix
    • meisam.mahdian
    • ankitabhopatkar13
    • maxvandop
    • tugbasariaktas
    • hbvndrzwt
    • sanjuavs
    • mx-dennis
    • martijn.raats
    • sangamleo
    • amir.afroozeh
    • aaatm
    • ray-mendix
    • borzoo.esmailloo
    • lisamx
    • nickjansen
    • mx-stevenlynagh
    • alexander_s
    • eefke86
    • qaurav20
    • sander-vdv
    • kmameletzi
    • alexander-ng-mx
    • jules.van.thillo
    • henkjan.van.henten.mendix
    • mx-chandrakantlotke
    • jurretanjamx
    • mxmelinda
    • mxraze
    • mx-vlad
    • julia-paranich-mx
    • mx-subhabratadas
    • jeremiah.mendixer
    • ralf-ren
    • muhong
    • mx-leondekuiper
    • mx-chandramohan
    • ref3oz
    • mx-yvann
    • mx-shivprasadjamdade
    • mx-rushikeshmandage
    • mx-jaro
    • ann.ye-mendix
    • ionut.holbea
    • mx-michael
    • mx-gaurao-burghate
    • mx-tejas