https://github.com/btford/angular-express-seed

A great starting point for writing AngularJS apps backed by an Express-powered node.js server.
https://github.com/btford/angular-express-seed

Last synced: 13 days ago
JSON representation

A great starting point for writing AngularJS apps backed by an Express-powered node.js server.

• Host: GitHub
• URL: https://github.com/btford/angular-express-seed
• Owner: btford
• Created: 2012-06-19T02:04:10.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2021-07-15T17:32:23.000Z (almost 3 years ago)
• Last Synced: 2024-05-09T20:09:05.152Z (about 2 months ago)
• Language: JavaScript
• Size: 18.9 MB
• Stars: 1,511
• Watchers: 103
• Forks: 597
• Open Issues: 25
• Metadata Files:
  • Readme: README.md

Lists

• awesome-seed - angular-express-seed - A great starting point for writing AngularJS apps backed by an Express-powered node.js server. (Seed List / Angular)

README

        
# Angular Express Seed

Start an awesome app with AngularJS on the front, Express + Node on the back. This project is an

application skeleton for a typical [AngularJS](http://angularjs.org/) web app for those who want

to use Node to serve their app.

The seed contains angular libraries, test libraries and a bunch of scripts all preconfigured for

instant web development gratification. Just clone the repo (or download the zip/tarball) and

you're ready to develop your application.

The seed app shows how to wire together Angular client-side components with Express on the server.

It also illustrates writing angular partials/views with the Jade templating library.

_Note: Although Jade supports interpolation, you should be doing that mostly on the client. Mixing

server and browser templating will convolute your app. Instead, use Jade as a syntactic sugar for

HTML, and let AngularJS take care of interpolation on the browser side._

## How to use angular-express-seed

Clone the angular-express-seed repository, run `npm install` to grab the dependencies, and start hacking!

### Running the app

Runs like a typical express app:

    node app.js

### Running tests

Coming soon!

### Receiving updates from upstream

Just fetch the changes and merge them into your project with git.

## Directory Layout

    

    app.js              --> app config

    package.json        --> for npm

    public/             --> all of the files to be used in on the client side

      css/              --> css files

        app.css         --> default stylesheet

      img/              --> image files

      js/               --> javascript files

        app.js          --> declare top-level app module

        controllers.js  --> application controllers

        directives.js   --> custom angular directives

        filters.js      --> custom angular filters

        services.js     --> custom angular services

        lib/            --> angular and 3rd party JavaScript libraries

          angular/

            angular.js            --> the latest angular js

            angular.min.js        --> the latest minified angular js

            angular-*.js          --> angular add-on modules

            version.txt           --> version number

    routes/

      api.js            --> route for serving JSON

      index.js          --> route for serving HTML pages and partials

    views/

      index.jade        --> main page for app

      layout.jade       --> doctype, title, head boilerplate

      partials/         --> angular view partials (partial jade templates)

        partial1.jade

        partial2.jade

## Example App

A simple [blog](https://github.com/btford/angular-express-blog) based on this seed.

## Contact

For more information on AngularJS please check out http://angularjs.org/

For more on Express and Jade, http://expressjs.com/ and http://jade-lang.com/ are

your friends.

## License

MIT