https://github.com/zmmbreeze/project-starter
Gulp + Browserify + LESS
https://github.com/zmmbreeze/project-starter
Last synced: about 2 months ago
JSON representation
Gulp + Browserify + LESS
- Host: GitHub
- URL: https://github.com/zmmbreeze/project-starter
- Owner: zmmbreeze
- Created: 2014-12-14T14:34:02.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2015-01-15T07:38:58.000Z (over 11 years ago)
- Last Synced: 2025-03-12T22:44:56.456Z (over 1 year ago)
- Language: CSS
- Homepage:
- Size: 176 KB
- Stars: 3
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
project-starter
============
Starter Gulp + Browserify + less project with examples of how to accomplish some common tasks and workflows. Base on [gulp-starter](https://github.com/greypants/gulp-starter).
Includes the following tools, tasks, and workflows:
- [Browserify](http://browserify.org/) (with [browserify-shim](https://github.com/thlorenz/browserify-shim))
- [Watchify](https://github.com/substack/watchify) (caching version of browserify for super fast rebuilds)
- [less](lesscss.org) (with [autoprefixer](https://github.com/sindresorhus/gulp-autoprefixer))
- [BrowserSync](http://browsersync.io) for live reloading and a static server
- Image optimization
- Error Notifications in Notification Center
If you've never used Node or npm before, you'll need to install Node.
If you use homebrew, do:
```
brew install node
```
Otherwise, you can download and install from [here](http://nodejs.org/download/).
### Install Gulp Globally
Gulp must be installed globally in order to use the command line tools. *You may need to use `sudo`*
```
npm install -g gulp
```
Alternatively, you can run the version of gulp installed local to the project instead with
```
./node_modules/.bin/gulp
```
### Install npm dependencies
```
npm install
```
This runs through all dependencies listed in `package.json` and downloads them
to a `node_modules` folder in your project directory.
### Run gulp and be amazed.
```
gulp
```
This will run the `default` gulp task defined in `gulp/tasks/default.js`, which does the following:
- Run 'watch', which has 2 task dependencies, `['setWatch', 'browserSync']`
- `setWatch` sets a variable that tells the browserify task whether or not to use watchify.
- `browserSync` has `build` as a task dependecy, so that all your assets will be processed before browserSync tries to serve them to you in the browser.
- `build` includes the following tasks: `['browserify', 'less', 'images', 'markup']`
### Configuration
All paths and plugin settings have been abstracted into a centralized config object in `gulp/config.js`. Adapt the paths and settings to the structure and needs of your project.