{"id":15314743,"url":"https://github.com/unframework/angular-seed","last_synced_at":"2025-10-09T00:32:50.432Z","repository":{"id":6160405,"uuid":"7390014","full_name":"unframework/angular-seed","owner":"unframework","description":"Seed project for angular apps. ","archived":false,"fork":true,"pushed_at":"2012-12-06T22:05:10.000Z","size":6329,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-04-14T18:22:14.395Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://angularjs.org/","language":"JavaScript","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"angular/angular-seed","license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/unframework.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-12-31T18:43:13.000Z","updated_at":"2019-08-13T15:13:52.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/unframework/angular-seed","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unframework%2Fangular-seed","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unframework%2Fangular-seed/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unframework%2Fangular-seed/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unframework%2Fangular-seed/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/unframework","download_url":"https://codeload.github.com/unframework/angular-seed/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219877247,"owners_count":16554912,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-01T08:46:54.886Z","updated_at":"2025-10-09T00:32:45.050Z","avatar_url":"https://github.com/unframework.png","language":"JavaScript","readme":"# angular-seed — the seed for AngularJS apps\n\nThis project is an application skeleton for a typical [AngularJS](http://angularjs.org/) web app.\nYou can use it to quickly bootstrap your angular webapp projects and dev environment for these\nprojects.\n\nThe seed contains AngularJS libraries, test libraries and a bunch of scripts all preconfigured for\ninstant web development gratification. Just clone the repo (or download the zip/tarball), start up\nour (or yours) webserver and you are ready to develop and test your application.\n\nThe seed app doesn't do much, just shows how to wire two controllers and views together. You can\ncheck it out by opening app/index.html in your browser (might not work file `file://` scheme in\ncertain browsers, see note below).\n\n_Note: While angular is client-side-only technology and it's possible to create angular webapps that\ndon't require a backend server at all, we recommend hosting the project files using a local\nwebserver during development to avoid issues with security restrictions (sandbox) in browsers. The\nsandbox implementation varies between browsers, but quite often prevents things like cookies, xhr,\netc to function properly when an html page is opened via `file://` scheme instead of `http://`._\n\n\n## How to use angular-seed\n\nClone the angular-seed repository and start hacking...\n\n\n### Running the app during development\n\nYou can pick one of these options:\n\n* serve this repository with your webserver\n* install node.js and run `scripts/web-server.js`\n\nThen navigate your browser to `http://localhost:\u003cport\u003e/app/index.html` to see the app running in\nyour browser.\n\n\n### Running the app in production\n\nThis really depends on how complex is your app and the overall infrastructure of your system, but\nthe general rule is that all you need in production are all the files under the `app/` directory.\nEverything else should be omitted.\n\nAngular apps are really just a bunch of static html, css and js files that just need to be hosted\nsomewhere, where they can be accessed by browsers.\n\nIf your Angular app is talking to the backend server via xhr or other means, you need to figure\nout what is the best way to host the static files to comply with the same origin policy if\napplicable. Usually this is done by hosting the files by the backend server or through\nreverse-proxying the backend server(s) and a webserver(s).\n\n\n### Running unit tests\n\nWe recommend using [jasmine](http://pivotal.github.com/jasmine/) and\n[Testacular](http://vojtajina.github.com/testacular/) for your unit tests/specs, but you are free\nto use whatever works for you.\n\nRequires [node.js](http://nodejs.org/), Testacular (`sudo npm install -g testacular`) and a local\nor remote browser.\n\n* start `scripts/test.sh` (on windows: `scripts\\test.bat`)\n  * a browser will start and connect to the Testacular server (Chrome is default browser, others can be captured by loading the same url as the one in Chrome or by changing the `config/testacular.conf.js` file)\n* to run or re-run tests just change any of your source or test javascript files\n\n\n### End to end testing\n\nAngular ships with a baked-in end-to-end test runner that understands angular, your app and allows\nyou to write your tests with jasmine-like BDD syntax.\n\nRequires a webserver, node.js + `./scripts/web-server.js` or your backend server that hosts the angular static files.\n\nCheck out the\n[end-to-end runner's documentation](http://docs.angularjs.org/guide/dev_guide.e2e-testing) for more\ninfo.\n\n* create your end-to-end tests in `test/e2e/scenarios.js`\n* serve your project directory with your http/backend server or node.js + `scripts/web-server.js`\n* to run do one of:\n  * open `http://localhost:port/test/e2e/runner.html` in your browser\n  * run the tests from console with [Testacular](vojtajina.github.com/testacular) via\n    `scripts/e2e-test.sh` or `script/e2e-test.bat`\n\n\n### Receiving updates from upstream\n\nWhen we upgrade angular-seed's repo with newer angular or testing library code, you can just\nfetch the changes and merge them into your project with git.\n\n\n## Directory Layout\n\n    app/                --\u003e all of the files to be used in production\n      css/              --\u003e css files\n        app.css         --\u003e default stylesheet\n      img/              --\u003e image files\n      index.html        --\u003e app layout file (the main html template file of the app)\n      index-async.html  --\u003e just like index.html, but loads js files asynchronously\n      js/               --\u003e javascript files\n        app.js          --\u003e application\n        controllers.js  --\u003e application controllers\n        directives.js   --\u003e application directives\n        filters.js      --\u003e custom angular filters\n        services.js     --\u003e custom angular services\n      lib/              --\u003e angular and 3rd party javascript libraries\n        angular/\n          angular.js        --\u003e the latest angular js\n          angular.min.js    --\u003e the latest minified angular js\n          angular-*.js      --\u003e angular add-on modules\n          version.txt       --\u003e version number\n      partials/             --\u003e angular view partials (partial html templates)\n        partial1.html\n        partial2.html\n\n    config/testacular.conf.js        --\u003e config file for running unit tests with Testacular\n    config/testacular-e2e.conf.js    --\u003e config file for running e2e tests with Testacular\n\n    scripts/            --\u003e handy shell/js/ruby scripts\n      e2e-test.sh       --\u003e runs end-to-end tests with Testacular (*nix)\n      e2e-test.bat      --\u003e runs end-to-end tests with Testacular (windows)\n      test.bat          --\u003e autotests unit tests with Testacular (windows)\n      test.sh           --\u003e autotests unit tests with Testacular (*nix)\n      web-server.js     --\u003e simple development webserver based on node.js\n\n    test/               --\u003e test source files and libraries\n      e2e/              --\u003e\n        runner.html     --\u003e end-to-end test runner (open in your browser to run)\n        scenarios.js    --\u003e end-to-end specs\n      lib/\n        angular/                --\u003e angular testing libraries\n          angular-mocks.js      --\u003e mocks that replace certain angular services in tests\n          angular-scenario.js   --\u003e angular's scenario (end-to-end) test runner library\n          version.txt           --\u003e version file\n      unit/                     --\u003e unit level specs/tests\n        controllersSpec.js      --\u003e specs for controllers\n        directivessSpec.js      --\u003e specs for directives\n        filtersSpec.js          --\u003e specs for filters\n        servicesSpec.js         --\u003e specs for services\n\n## Contact\n\nFor more information on AngularJS please check out http://angularjs.org/\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funframework%2Fangular-seed","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Funframework%2Fangular-seed","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funframework%2Fangular-seed/lists"}