Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jbutko/angularjs-boilerplate
Simple AngularJS Boilerplate to kick start your new project with SASS support and Gulp watch/build tasks
https://github.com/jbutko/angularjs-boilerplate
angularjs-boilerplate sass-support
Last synced: 4 days ago
JSON representation
Simple AngularJS Boilerplate to kick start your new project with SASS support and Gulp watch/build tasks
- Host: GitHub
- URL: https://github.com/jbutko/angularjs-boilerplate
- Owner: jbutko
- License: mit
- Created: 2015-03-22T16:25:42.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-04-17T17:41:13.000Z (7 months ago)
- Last Synced: 2024-09-26T07:24:40.324Z (about 2 months ago)
- Topics: angularjs-boilerplate, sass-support
- Language: CSS
- Homepage: http://www.jozefbutko.com/angularjs-boilerplate/
- Size: 276 KB
- Stars: 403
- Watchers: 24
- Forks: 152
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Disclaimer:
For updated version of AngularJS-Boilerplate please use this one: https://github.com/jbutko/ExpressJS-Socket.IO-AngularJS-Boilerplate/tree/master/client
It's component based, based on Angular v1.6.1 and as routing library is used Angular UI Router v1.
# AngularJS-Boilerplate
Simple AngularJS Boilerplate to kick start your new project with SASS support and Gulp watch/build tasks
# Features
* SASS support including sourceMaps
* Minimal CSS styling of the view
* Gulp watch, build and local server tasks
* Responsive navigation
* Owl slider directive
* localStorage service for set, get, remove data
* queryService $http wrapper to handle calls
* clear folder structure
* less than 10 request in build version
* minified CSS and JS build files
* google analytics snippet
## Download
```bash
bower install angularjs-boilerplate
```
or
```bash
git clone https://github.com/jbutko/AngularJS-Boilerplate.git
```
## 1. Setup
```bash
npm install
```
- install all npm and bower dependencies
**Note:** If `npm install` fails during dependency installation it will be likely caused by `gulp-imagemin`. In that case remove `gulp-imagemin` dependency from `package.json`, run `npm install` again and then install `gulp-imagemin` separately with following command: `npm install gulp-imagemin --save-dev`
## 2. Watch files
```bash
npm start
```
or
```bash
gulp
```
- all SCSS/HTML will be watched for changes and injected into browser thanks to BrowserSync
## 3. Build production version
```bash
npm run build
```
or
```bash
gulp build
```
- this will process following tasks:
* clean _build folder
* compile SASS files, minify and uncss compiled css
* copy and optimize images
* minify and copy all HTML files into $templateCache
* build index.html
* minify and copy all JS files
* copy fonts
* show build folder size
## 4. Start webserver without watch task
```bash
npm run server
```
or
```bash
gulp server
```
## 5. Start webserver from build folder
```bash
npm run serverbuild
```
or
```bash
gulp server-build
```
## Contact
Copyright (C) 2015 Jozef Butko
[www.jozefbutko.com/resume](http://www.jozefbutko.com/resume)
[www.github.com/jbutko](http://www.github.com/jbutko)
[@jozefbutko](http://www.twitter.com/jozefbutko)
Released under MIT license
## Changelog
### 1.1.7
- Install all dependencies with 'npm install' (bower included) - pull req #7 by @bbodine1
15.05.2015
### 1.1.6
- Cleaned up the gulpfile with gulp-load-plugins - pull req #6 by @davieschoots
26.04.2015
### 1.1.5
- added MIT License
19.04.2015
### 1.1.4
- added minification of JS files in build task
- added favicon
- gulpfile.js beautify and clean up
- added owl carousel into demo
04.04.2015
### 1.1.3
- index.html update: added browserupgrade tag
- index.html update: http-equiv meta tag, google analytics support
- comments update in gulpfile.js
- gulpfile.js formatting
- pull request #1: removed duplicate gulp require in gulpfile.js
04.04.2015
### 1.1.2
- package.json and gulpfile.js clean up
02.04.2015
### 1.1.1
- opened responsive nav fix, css build .min appendix, live demo, github icons
31.03.2015
### 1.1.0
- many improvements: responsive nav, code clean up, gulp angular templateCache
support, gulp task for local server, SASS sourceMaps support
29.03.2015
### 1.0.0
- initial release
22.03.2015