@digipolis/start-ui

Digipolis starter kit

Usage no npm install needed!

<script type="module">
  import digipolisStartUi from 'https://cdn.skypack.dev/@digipolis/start-ui';
</script>

README

Digipolis UI starter kit

This starter kit makes it easy for you to create a frontend Antwerp UI and/or backend nodejs app.

Basic usage

> npm install -g @digipolis/start-ui
> cd your-app
> digipolis-start-ui

Advanced

Run the starter kit without questionnaire

> digipolis-start-ui --no-setup

Run the help command in order to see all available configuration options:

> digipolis-start-ui --help

Params

  • -V, --version output the version number
  • -d, --debug debug
  • -S, --no-setup Skip setup questions
  • -f, --frontend <frontend> Frontend (angular or react) (default: "react")
  • -b, --backend <backend> Backend framework (Node.js or none) (default: "nodejs")
  • -n, --name <name> The name for your app (default: "Starter app")
  • -b, --branding <branding> Branding (Antwerp, Digipolis or ACPaaS) (default: "Antwerp")
  • -F, --no-flexboxgrid Don't use the Flexbox grid
  • -R, --no-routing Don't add basic routing
  • -d, --database <database> Database (MongoDB or none) (default: "mongodb")
  • -A, --no-auth Don't add basic authentication
  • -h, --help output usage information

Working with the starterkit

Config

This folder contains basic configuration for back-end, front-end, branding, questions and general options.

Utils

Small utils to help the generators.

Generators

Angular

Angular-cli based generator to generate a basic app with the option to add routing and/or authentication.

.Net

Not yet implemented.

Node.js

A Node.js backend app wiht several options for routing/authenticatin, etc...

React

Create-react-app based generator to generate a basic app with the option to add routing and/or authentication.

Contributing

Pull requests are always welcome, however keep the following things in mind:

  • New features (both breaking and non-breaking) should always be discussed with the repo's owner. If possible, please open an issue first to discuss what you would like to change.
  • Fork this repo and issue your fix or new feature via a pull request.
  • Please make sure to update tests as appropriate. Also check possible linting errors and update the CHANGELOG if applicable.

Support

Jasper Van Proeyen (jasper.vanproeyen@digipolis.be)