Repository files navigation

Yeoman generator for creating MEAN/SEAN stack applications, using ES2017, MongoDB/SQL, Express, Angular, and Node - lets you quickly set up a project following best practices.

Installyo,gulp-cli, andgenerator-angular-fullstack:

npm install -g yo gulp-cli generator-angular-fullstack

Please note: If you run into trouble compiling native add-ons during the installation, follownode-gyp's short guide onrequired compilation tools.

Then, to run your app (make sure the MongoDB daemon is running if you selected Mongo), run the following to start your server:

npm run start:server

and the following to start the Webpack dev server for the front-end:

npm run start:client

The Webpack server will tell you which port to access the app at (usuallyhttp://localhost:8080/).

Runyo angular-fullstack

yo angular-fullstack

See theGetting Startedguide for more information.

• MongoDB - Download and InstallMongoDB - If you plan on scaffolding your project with mongoose, you'll need mongoDB to be installed and have themongod process running.
  • If you haveDocker installed, you can easily run a test database withdocker run -p 27017:27017 --name afs-mongo -d mongo
• The project's JavaScript is written in ECMAScript 2015. If you're unfamiliar with the latest changes to the specification for JavaScript, check outhttp://es6-features.org/

General

• Build Systems:Gulp
• Testing:
  • Jasmine
  • Mocha + Chai + Sinon
    • Chai assertions:
      • Expect
      • Should

Client

• Scripts:JavaScript (Babel),TypeScript
• Module Systems:Webpack
• Markup:HTML,Pug
• Stylesheets:CSS,Stylus,Sass,Less
• CSS Frameworks:Bootstrap
  • Option to includeUI Bootstrap

Server

• Scripts:JavaScript (Babel),TypeScript (planned)
• Database:
  • None,
  • MongoDB,SQL
    • Authentication boilerplate:Yes,No
    • oAuth integrations:Facebook,Twitter,Google
    • Socket.io integration:Yes,No

Available generators:

• App
  • angular-fullstack (akaangular-fullstack:app)
• Server Side
  • angular-fullstack:endpoint
• Client Side (viagenerator-angular-fullstack-component)
  • angular-fullstack:route
• To be re-updated:
  • angular-fullstack:component
  • angular-fullstack:controller
  • angular-fullstack:filter
  • angular-fullstack:directive
  • angular-fullstack:service
  • angular-fullstack:provider
  • angular-fullstack:factory
  • angular-fullstack:decorator
• Deployment
  • angular-fullstack:openshift
  • angular-fullstack:heroku

Check out ourdocumentation home page.

See thecontributing docs

When submitting an issue, please follow theYeoman issue guidelines. Especially important is to make sure Yeoman is up-to-date, and providing the command or commands that cause the issue, as well as any stack traces.

BSD license