Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/j-d-carmichael/quilk
quilk
https://github.com/j-d-carmichael/quilk
babel css javascript less rsync sass sass-watcher watcher
Last synced: 20 days ago
JSON representation
quilk
- Host: GitHub
- URL: https://github.com/j-d-carmichael/quilk
- Owner: j-d-carmichael
- License: mit
- Created: 2016-08-28T12:42:26.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2023-12-20T11:56:21.000Z (11 months ago)
- Last Synced: 2024-09-14T16:06:05.491Z (about 2 months ago)
- Topics: babel, css, javascript, less, rsync, sass, sass-watcher, watcher
- Language: JavaScript
- Size: 1.92 MB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
 
[](https://nodei.co/npm/quilk/)
# Quilk
**Table of Contents** *generated with [DocToc](https://github.com/thlorenz/doctoc)*
- [Documentation here](#documentation-here)
- [Setup](#setup)
- [What is does](#what-is-does)
- [Common rsync setup](#common-rsync-setup)
- [Kitchen'esk sink exmaple config file:](#kitchenesk-sink-exmaple-config-file)
- [Tips](#tips)
## Documentation here
[https://johndcarmichael.github.io/quilk/](https://johndcarmichael.github.io/quilk/)
---
## Setup
1 - Install, `npm install quilk --save-dev` then add to your package.json file's script block:
```
...
"scripts": {
...
"quilk": "quilk -- d=yourdevelopername"
...
},
...
```
2 - Add your quilk.js(on) file, either vua `npm run quilk init` or build your own (see the example below).
3 - Run your quilk build file with any of the following options `npm run quilk` runs the default user from the quilk file, or specify the user `npm run quilk developer=john` and lastly add a watch flag to re-run the modules after files change
### What is does
In brief (see the example quilk file before), quilk is a lightweight standardised module runner. Pre-baked modules in quilk can do the following:
Watch a file base and trigger modules on file changes via chokidar, modules include:
- babelify
- babelify_app
- babelify_vendor
- browserify_bundle
- command_run
- copy
- css_fixed
- email
- js_find
- js_fixed
- js_strip
- just_for_fun
- node_minify
- rsync
- sass_find
- sass_std
- webhook
---
### Common rsync setup
`quilk.js` will simply sync files from your project to a server. Adding the watch flag will sync the changes files.
```javascript
module.exports = {
// The modules this quilk file should run
modules: [
{
name: 'Rsync it',
module: 'rsync',
ignore: {
windows: [],
mac: [],
linux: [],
global: [
'.env',
'.git/*',
'node_modules'
]
}
}
],
// Watcher don't run the modules when files change here...
dont_watch: [
'.git/',
'node_modules',
'vendor',
],
// Tell the watcher which project relatives to watch, if not set defaults to the project base
watch_only: [
'/src',
],
// Injections chokidar_options to chokidar
chokidar_options: {
atomic: 50,
depth: 120
},
// The developers own custom settings
developers: {
default: {
platform: 'linux',
notifier: {
on: false
},
rsync: {
// The settings below would result in a command:
// rsync -avz --delete -e 'ssh -J john@myjump:666' ./ www-data@myserver:/var/www/project-x/
e: 'ssh -J john@myjump:666',
localPath: './',
remote: 'www-data@myserver',
serverPath: '/var/www/project-x/'
}
},
}
}
```
### Kitchen'esk sink exmaple config file:
`quilk.js`:
```javascript
module.exports = {
// The modules this quilk file should run
modules: [
{
name: '(custom project specific module) Preapre the js config files based on the .env file',
module: 'prepareJSConfigFiles'
},
{
name: 'App file',
module: 'babelify',
configure: {
babelrc: '.babelrc'
},
extensions: ['.js'],
debug: true,
entries: 'resources/assets/js/app.js',
target: '/public/js/app.js'
},
{
name: 'App CSS',
module: 'sass_std',
outputStyle: 'expanded',
sourceComments: true,
input_path: 'resources/assets/sass/app.scss',
target: '/public/css/app.css'
},
{
name: 'Rsync it',
module: 'rsync',
set: [ /* Additional rsync options to be passed */
'--copy-links',
'--quiet'
],
ignore: {
windows: [
/* Working on windows for a unix production env makes little sense, as such often certain files should not be synced */
'vendor'
],
mac: [],
linux: [],
global: [
'.git/*',
'.idea/*',
'storage/app/*',
'storage/logs/*',
'node_modules'
]
}
}
],
// The projects custom quilk modules location
custom_module_path: 'quilk_modules',
// Watcher don't run the modules when files change here...
dont_watch: [
'.git/',
'node_modules',
'vendor',
'public/css',
'public/fonts',
'public/js'
],
// The watcher options. See https://www.npmjs.com/package/chokidar for all the settings available
chokidar_options: {
awaitWriteFinish: false
},
// Stop the watcher being triggered multiple times by other watchers, this grace time defaults to 500.
watcher_wait_between_changes: 500,
// Additional modules to run for live or staging, eg node_minify for js and css
release_commands_or_modules: {
prod: {
post: [{
name: 'minify the vendor js',
module: 'node_minify',
type: 'uglifyjs',
input: ['/public/js/app.js'],
target: '/public/js/app.js'
}, {
name: 'minify the css',
module: 'node_minify',
type: 'sqwish',
input: ['/public/css/app.css'],
target: '/public/css/app.css'
}]
}
},
// The developers own custom settings
developers: {
default: {
platform: 'windows',
notifier: {
on: false,
style: 'WindowsBalloon',
time: 5000,
sound: true
}
},
john: {
platform: 'windows',
notifier: {
on: false
},
chokidar_options: {
awaitWriteFinish: true,
atomic: 50
},
rsync: {
localPath: './',
remote: 'www-data@myserver',
serverPath: '/var/www/vhosts/project-x/'
}
}
}
}
```
### Tips
1. The leading slash for everything is not relevant, add or not, quilk will only ever work within the current directory of the quilk file or a child directory. This is for security to prevent careless mistakes and potential loss of work.
1. The rsync module... be sure to add the trailing slash else you will end up with a directory in a directory. And ALWAYS double check your paths!
1. Most in-built modules will pass in the options from the quilk file directly to the npm package they are an abstraction for, so for full options please check the individual npm packages, eg chokidar
1. Got more than 1 watcher on the go, check out the `watcher_wait_between_changes` flag if you're getting collisions.
1. Don't forget to add your own `.babelrc` file when using any of `babel` modules as mentioned above
1. The `watch` flag will rebuild even when it sees a new built file, to prevent this you can tell the watch to not watch specific paths (this is added a regex pattern internally to chokidar)