
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
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.gitEnter the project folder
cd angular-seedInstall dependencies
npm installStart the dev server
npm start - 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
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
| Project | Stars | Type | Level | Updated | Best for |
|---|---|---|---|---|---|
| angular-seed (this) | 13.1k | Dev tool | beginner | 4.7 years ago | Developers maintaining or learning an AngularJS 1.x codebase |
| angular-cli | 27k | CLI | beginner | 4 days ago | Developers starting a new Angular web application |
| vite | 83.7k | Dev tool | intermediate | 4 days ago | Frontend developers starting a new modern web project |
| create-react-app | 103k | Dev tool | beginner | 1.7 years ago | Following 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.