开源软件名称（OpenSource Name）：

开源软件地址(OpenSource Url)：

开源编程语言(OpenSource Language)：

开源软件介绍(OpenSource Introduction)：

Gulp Starter Pack

This package intended to solve common front-end development tasks. Works best for psd/sketch to html projects and save you a lot of time setting up local environment

How to start

• yarn or npm i - install npm dependencies
• gulp - run dev-server
• gulp build - build project from sources
• yarn deploy or npm run deploy - run build and deploy to surge

List of Gulp tasks

To run separate task type in command line gulp [task_name]. Almost all tasks also have watch mode - gulp [task_name]:watch, but you don't need to use it directly.

Main tasks

Other tasks

All available tasks are placed in a folder ./gulp/tasks as separate .js files.

General instructions

• Layout is based on components. ./src/components include folders named by blocks. Each block have _name.pug file and _name.{sass,scss} stylesheet

Flags

• gulp --open or gulp server --open - run dev server and then open preview in browser
• gulp --tunnel=[name] or gulp server --tunnel [name] - runs dev server and allows you to easily share a web service on your local development machine (powered by localtunnel.me). Your local site will be available at [name].localtunnel.me.
• gulp [task_name] --prod or gulp [task_name] --production - run task in production mode. Some of the tasks (like, sass or js compilation) have additional settings for production mode (such as code minification), so with this flag you can force production mode. gulp build uses this mode by default.

Deploy

There are git hooks for surge deploy. Every push will execute deploy to specific surge domain of ./dist folder

Exmaple: surge --project ./dist --domain projectname.surge.sh

If it's not working correctly, try installing git-scripts manually: yarn add git-scripts --save

use yarn surge or npm run surge to do the same. deploy command will run build with production flag and upload to surge

Other

You can also use npm scripts:

• yarn start or npm start - same as gulp default.
• yarn build or npm run build - same as gulp build.
• yarn surge or npm run surge - deploy ./dist folder to surge (used for previews). Request deploy rights from owner (surge --add [email protected])