Source for npm package vulgar
. vulgar-cli
is a core package of the vulgar.io
project and is used primarily to deploy and manage full-stack web applications developed using MEAN
technologies.
The cli
currently provides the functionality to deploy a fresh copy of a MEAN
application as well as assist you in creating the initial admin account. Automated dependency installation is also an option.
Various scaffolds are able to be generated through simple interaction with the cli
. This serves as an easy starting point to begin coding anything across the stack. Don't waste your time coding boilerplate, start with functional code.
See https://github.com/datatypevoid/vulgar for more in-depth information about the v#!g@r
flavor of MEAN
stack.
# install global prerequisites
$ npm install -g vulgar-cli generator-vulgar
# create a new mean app
$ vulgar init <nameOfApplication>
# add required global libraries
$ npm install -g typings webpack webpack-dev-server concurrently
# install the repo with npm
# (if you declined automated dependency installation in the wizard)
$ npm install
# build code
$ npm run build
# start up the stack
# this command runs two commands in parallel via `concurrently`:
# `npm run server` starts up `webpack-dev-server` allowing for
# hot module reloading
# `npm` run watch` uses `webpack` to watch the necessary files
# and build on file change
$ npm start
# in a separate terminal:
# start `Express` server
$ gulp serve
go to http://0.0.0.0:8080 or http://localhost:8080 in your browser
$ vulgar --help
$ vulgar init <NameOfYourApp>
You can use $ vulgar scaffold
to generate various Angular 2 components:
# generate a new Angular 2 component
$ vulgar scaffold ngc
# generate a new Angular 2 directive
$ vulgar scaffold ngd
# look at this cool new Angular 2 pipe
$ vulgar scaffold ngp
# and this awesome Angular 2 service
$ vulgar scaffold ngs
You can find all possible scaffolds in the table below:
Scaffold | Usage |
---|---|
Component | $ vulgar scaffold ngc penguin |
Directive | $ vulgar scaffold ngd elephant |
Pipe | $ vulgar scaffold ngp lemur |
Service | $ vulgar scaffold ngs coyote |
You can generate a new Angular route via the following command (note the singular used in nyan
):
$ vulgar scaffold ngr nyan
The cli
will prompt the user to select the parent module, confirm the name for their newly minted routable Angular
component, as well as define the Angular
route path
for the children components.
This will create a folder with a routable component (nyan-root.component.ts
) with two sub-routes. The file structure will be as follows:
...
|-- app
| |-- nyan
| | |-- nyan-detail.component.html
| | |-- nyan-detail.component.sass
| | |-- nyan-detail.component.spec.ts
| | |-- nyan-detail.component.ts
| | |-- nyan-list.component.html
| | |-- nyan-list.component.sass
| | |-- nyan-list.component.spec.ts
| | |-- nyan-list.component.ts
| | |-- nyan-root.component.spec.ts
| | |-- nyan-root.component.ts
| | |-- nyan.service.spec.ts
| | |-- nyan.service.ts
| |-- ...
|-- app.ts
...
Afterwards to use the new route open your main app component, import nyan-root.component.ts
and add it in the route config:
@RouteConfig([
{path:'/nyan/...', name: 'NyanRoot', component: NyanRoot}
])
Visiting http://localhost:8080/nyan
will show the nyan
list.
You can use $ vulgar scaffold
to generate various back-end components:
# generate a new Mongoose model
$ vulgar scaffold m leopard
# generate a new Express route
$ vulgar scaffold r leopard
Afterwards to use the new model and route together, open app/routes.js
, import your new route and add it to the RESTful API
section:
// Load our API routes for the `new` component
import leopardRoutes from './routes/_leopard.router.js';
// . . .
// #### RESTful API Routes
// Pass in our Express app and Router
leopardRoutes(app, router);
You can find all possible scaffolds in the table below:
Scaffold | Usage |
---|---|
Model | $ vulgar scaffold m leopard |
Route | $ vulgar scaffold r leopard |
Install Dependencies:
$ cd <NameOfYourApp> && npm install
Build Code
$ npm run build
Start Server
$ gulp serve
Watch & Bundle Front-End With Webpack
$ npm run watch
Hot Module Reloading for Front-End Via Webpack
$ npm run server:dev:hmr
Contributions are welcome but they myst clearly demonstrate a new concept in accordance with the Angular 2 Style Guide. Come join the discussion on Slack and help guide development.
Contact us anytime for anything about this repo, Angular 2, or MEAN stack development in general.
enjoy -- Da5id
Looking for corporate Angular/MEAN training, want to host us, or Angular/MEAN consulting? david.r.niciforovic@gmail.com