Konstruct Cli

Gem Version

The Konstruct Cli provides tools to make working with Konstruct painless and quick. You can access documentation, build a new project structure and scaffold a new site with simple to use commands.

Key Features

  • Set up a new project structure in seconds.
  • Scaffold out a new HTML, Jekyll or Angular site in seconds.
  • Globally installed Gulp with Konstruct.gulp.
  • Develop with SASS, Browserify (CommonJS).
  • Build process to optimise assets for deployment in separate git branches.
  • Quick link to Konstruct Documentation.

Installation

You can install Konstruct Cli by running:

$ gem install konstruct

Commands

The Cli has a few very simple commands. If you get stuck simply $ konstruct --help for help. You can also get instructions for every command with $ konstruct [COMMAND] --help

Konstruct Commands

Folders

$ konstruct folders

Scaffolds a set of project folders from a template to help you organise your project better.

Customize Template: You can customize the folder structure in ~/.konstruct/config.yml.

Create

$ konstruct create

Creates a new Konstruct starter project through an interactive wizard.

Refresh

$ konstruct refresh

Refreshes the project by installing dependencies again. Useful if you inherit a repo from another developer.

Watch

$ konstruct watch

Runs the global Gulp tools from your current working directory.

Build

$ konstruct build [options]

Options:

  • --staging : Run build process on staging branch.
  • --production : Run build process on production branch.

Runs build scripts & optimisations on your codebase in the branches you specified in options.

Currently optimising:

  • Minify JS
  • Minify CSS
  • Optimise images

Documentation

$ konstruct documentation

Loads up the Konstruct Documentation in your default browser.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/konstruct/konstruct.cli. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

The gem is available as open source under the terms of the MIT License.