readme.md

AngularJS Full-Stack generator

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

Generated project:

Usage

Install yo, gulp-cli, and generator-angular-fullstack@beta:

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

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

---

Run yo angular-fullstack

yo angular-fullstack

See the Getting Started guide for more information.

Prerequisites

• MongoDB - Download and Install MongoDB - If you plan on scaffolding your project with mongoose, you'll need mongoDB to be installed and have the mongod process running.
• The project's JavaScript is written in ECMAScript 2015. If you're unfamiliar with the latest changes to the specification for JavaScript, check out http://es6-features.org/

Supported Configurations

General

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

Client

• Scripts: JavaScript (Babel), TypeScript
• Module Systems: Webpack, SystemJS + JSPM (maybe)
• Markup: HTML, Pug
• Stylesheets: CSS, Stylus, Sass, Less
• Angular Routers: ngRoute, ui-router
• CSS Frameworks: Bootstrap
  • Option to include UI 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

Generators

Available generators:

• App
  • angular-fullstack (aka angular-fullstack:app)
• Server Side
  • angular-fullstack:endpoint
• Client Side (via generator-ng-component)
  • angular-fullstack:route
  • 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

Documentation

Check out our documentation home page.

Contribute

See the contributing docs

When submitting an issue, please follow the Yeoman 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.

License

BSD license

Backers

Support us with a monthly donation and help us continue our activities. [Become a backer]

Sponsors

Is your company using Angular-FullStack? Ask your boss to support the project. You will get your logo on our README on Github with a link to your site. [Become a sponsor]