Skip to content

angular-seed

A starter skeleton for AngularJS (v1) web apps with a sample app, npm setup, and test tooling.

Stars
13.1k
Forks
6.7k
Licence
MIT
Language
JavaScript
Last update
4.7 years ago
Type
Dev tool

This repository is archived and no longer maintained.

What it is

angular-seed is a starting template for building a web app with AngularJS, the older 1.x version of the Angular framework. It includes a small sample app with two linked views and controllers, plus preconfigured npm scripts for running a dev server and running unit and end-to-end tests. The repository is archived, so it reflects the AngularJS-era setup rather than current Angular.

  • Clone the repo and run the included sample app in a browser at localhost:8000
  • Start a small AngularJS prototype using the directory layout as a template
  • Run Jasmine unit tests with Karma in watch mode while editing code
  • Run Protractor end-to-end tests against the local dev server

Great for

  • Developers maintaining or learning an AngularJS 1.x codebase
  • Students who want a minimal example of how AngularJS views and controllers fit together
  • Anyone who wants a preconfigured Jasmine and Karma test setup for a simple browser app

Not ideal for

  • New projects on modern Angular: the repository is archived and targets AngularJS, which is a different framework from current Angular
  • Teams that need actively maintained tooling, since the last push was in February 2022 and the project is archived
  • People who need a backend, since the README describes a client-side app served by a local web server

How to get it

  1. 1

    Clone and build from source

    You'll need: git · Node.js and npm · Java Development Kit (JDK), only for end-to-end tests

    Clone the repository

    git clone https://github.com/angular/angular-seed.git

    Enter the project folder

    cd angular-seed

    Install dependencies

    npm install

    Start the dev server

    npm start
  2. 2

    Run it

    • Run npm install to fetch tools and AngularJS into app/lib
    • Run npm start to launch the development web server
    • Open localhost:8000/index.html in a browser to see the sample app
  3. 3

    Get the most out of it

    • Use npm test to run unit tests in watch mode so they re-run on each save
    • Use npm run test-single-run for a one-time test pass
    • Use npm run update-deps to update dependencies within their package.json ranges
    • Use index-async.html with npm run update-index-async if you want asynchronous script loading

Downloads

Strengths

  • Gives a clear, small example of an AngularJS app layout with separate views, controllers, and tests
  • Dependencies and the AngularJS library are installed through npm and copied into app/lib automatically
  • The README documents the test setup and the directory structure in detail

Trade-offs

  • Archived and last pushed in February 2022, so it is not maintained
  • Targets AngularJS 1.x, not the current Angular framework
  • End-to-end tests need a Java Development Kit installed for the Selenium server

How it compares

ProjectStarsTypeLevelUpdatedBest for
angular-seed (this)13.1kDev toolbeginner4.7 years agoDevelopers maintaining or learning an AngularJS 1.x codebase
angular-cli27kCLIbeginner4 days agoDevelopers starting a new Angular web application
vite83.7kDev toolintermediate4 days agoFrontend developers starting a new modern web project
create-react-app103kDev toolbeginner1.7 years agoFollowing an existing React tutorial that uses Create React App

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.