harp-scripts :zap:

Opinionated, zero-configuration, front-end development automation. Based on harp.

Useful for hotsites, rapid web prototyping & static site management.

Features

• Fast. Live-Reloading based development.
• Easy. Deploy to surge.sh with a single command.
• ZeroConf. Use your favorite pre-processor without managing gulp/grunt/etc.
• Extensible. Everything is composable, every command adheres to simple principles.
• Fully Featured. All harp features work.

Dependencies

| Dependency | Minimum Version | | --- | --- | | node | v6 | | bash | v3* |

* Built-in on MacOS & Modern Linux.

Instalation:

$ npm i --save harp harp-scripts

CLI Usage:

$ harp-scripts [command] [argument]

Commands:

| comand | argument | description | | --- | --- | --- | | compile | outputPath* | Compile harp project. | | help | command* | Show the help section for command. | | merge | file† | Inline all file dependencies. | | start | | Run production server. | | surge.sh | compiledPath* | Deploy project to surge.sh. | | test | | Test your project harp compilation. | | uglify | jadeFile | Concatenate javascript files. | | watch | | Run a development server with browser-sync. |

* Optional argument. † Only jade or stylus files supported.

Environment Variables:

| name | description | | --- | --- | | PORT | Which port to listen on. | | DOMAIN | Which domain to deploy to. | | NODE_ENV | node enviroment for the harp processor. | | NO_CLEANUP | Dont remove output folder before compiling. |

Roadmap:

Deployment options:

• [x] surge.sh
• [ ] gh-pages
• [ ] netlify
• [ ] gitlab-pages
• [ ] gitlab-pipeline

Developer Experience:

• [ ] Interactive Project Generator
• [ ] Commit Hook For Test
• [ ] Better Documentation
• [ ] Integration Tests

Inspiration:

• harp
• react-scripts
• browser-sync