Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Yeoman (n) 1. A noble servant, carrying out various duties for the sovereign. Associated with hard toil. 2. Your new favorite web application stack and development tool.

branch: master

This branch is 0 commits ahead and 0 commits behind master

Fetching latest commit…

Cannot retrieve the latest commit at this time

readme.md

Welcome, Friend! Build Status

Yeoman is a robust and opinionated client-side stack, comprising tools and frameworks that can help developers quickly build beautiful web applications. We take care of providing everything needed to get started without any of the normal headaches associated with a manual setup. Builds upon great tools like grunt the task runner, bower the package manager for the web, and our own homebrewed generator system.

Website   Documentation   Submit issue

image

Installation

npm install -g yeoman

Node.js 0.8.x required

Try the audit script to see what you need in place:

curl -L get.yeoman.io | bash

You can follow its guidance or simply walk through the installation procedure.

Issue submission

Make sure you've read the issue submission guidelines before you open a new issue.

Overview

Yeoman supports a powerful set of high-level commands:

     init  # Initialize and scaffold a new project using generator templates
    build  # Build an optimized version of your app, ready to deploy
   server  # Launch a preview server which will begin watching for changes
     test  # Run a Mocha test harness in a headless PhantomJS

  install  # Install a package from the clientside package registry
uninstall  # Uninstall the package
   update  # Update a package to the latest version
     list  # List the packages currently installed
   search  # Query the registry for matching package names
   lookup  # Look up info on a particular package

Example usage

A common initial workflow with Yeoman might be:

yeoman init         # Invoke the most basic application scaffold (Bootstrap, Boilerplate etc.)
yeoman server       # Fire off a file watch/server process which also places an
                    # intermediate build of your project in `temp`
yeoman build        # Build your project, creating an optimized version in a new `dist` directory
yeoman server:dist  # Serve up the production-ready version of your application
yeoman test         # Test your app

Some more examples of how to use our commands:

# Generators
yeoman init ember                           # Create a "Hello World" Yeoman project with the Ember Starter Kit
yeoman init backbone                        # Backbone-Rails generator scaffold
yeoman init angular                         # Invoke the AngularJS generator scaffold
yeoman init angular:controller name         # Invoke the AngularJS Controller sub-generator

# Package management
yeoman search jquery                        # Lookup jQuery in the Bower registry
yeoman install jquery underscore [depName]  # Install a dependency or dependencies
yeoman update jquery                        # Update a specific dependency (e.g jquery)

Bower

Yeoman uses Bower as its package manager. The Bower registry is currently being populated, you may find that certain packages work and others do not. We are actively working with the Bower team to resolve this issue.

image

Platform Support

Yeoman supports OS X, Linux, FreeBSD, with partial Windows support. We will be aiming to bring in full support for Windows in a future version.

Contribute

See the contributing docs

Links

Team

Yeoman was beautifully crafted by these people and bunch of awesome contributors

Paul IrishPaul Irish  Addy OsmaniAddy Osmani  Mickael DanielMickael Daniel  Sindre SorhusSindre Sorhus  Eric BidelmanEric Bidelman Frederick RosFrederick Ros

License

BSD license
Copyright (c) Google

Something went wrong with that request. Please try again.