Coder Social home page Coder Social logo

ilicmarko / maverick-cli Goto Github PK

View Code? Open in Web Editor NEW
1.0 2.0 0.0 243 KB

Handcrafted CLI to make my front-end workflow much easier.

License: MIT License

JavaScript 70.48% CSS 15.87% HTML 12.84% Makefile 0.80%
cli maverick-cli pug gulp webapp scss scaffold

maverick-cli's Introduction

Maverick CLI Logo

Build Status npm version Dev dep Coverage Status

Maverick CLI


Maverick CLI lets you create a scaffolding for your next project with ease. Maverick CLI is based on a popular Yeoman generator webapp, with some changes.

Features

  • enable ES2015 features using Babel
  • CSS Autoprefixing
  • Built-in preview server with BrowserSync
  • Automagically compile Sass with libsass
  • Automagically compile Pug
  • Automagically lint your scripts
  • Map compiled CSS to source stylesheets with source maps
  • Awesome image optimization
  • Automagically wire-up dependencies installed with Bower

Installation

On macOS, Linux, or Windows run the following:

npm install -g maverick-cli

That is it!

Gulp Commands

  • gulp serve to preview and watch for live changes
  • gulp or gulp build to build the app for production
  • gulp serve:dist to preview the production build

CLI Commands

Init

maverick init <path> [Project name] [options] - to scaffold your webapp ( is optional)

Options:

--skip-install to skip the execution of bower and npm installation after scaffolding.

SASS

maverick sass [options] [File name] - create a SCSS file.

Options:

Options argument is required.

  • -c or --component to add a component, this also adds a css selector.
  • -e or --element to add an element
  • -t or --tool to add a tool
  • -u or --utility to add a utility
  • -p or --plugin to add a plugin

Example

maverick sass -c "responsive-img"

Pug

maverick pug [File name] to create a pug page

Options:

  • -t or --title <title> to add a title to the page

If you don't provide the title it will be empty.

Project Structure

There is a well-defined project structure that must be respected.

src
├───fonts
├───images
├───js
├───sass
│   ├───components
│   ├───elements
│   ├───generic
│   ├───plugins
│   ├───tools
│   └───utilities
└───views
    ├───inc
    └───layouts

SASS Folder

This is where all the .scss files are found, gulp will watch for changes in this folder.

  • /components - Complete chunks of UI, like navigation, cards, panels etc..
  • /elements - Unclassed HTML elements, like a, h1, body, blockquote etc..
  • /generic - Reset and normalize css.
  • /plugins - SCSS files from imported plugins, like owl-carousel, popper etc..
  • /tools - Mixins and functions
  • /utilities - Override and helper functions, they are usually high-priority (!important)

SCSS files shouldn't be created manually, CLI should be used for that.

Views folder

This is where all the .pug files are found, gulp will watch for changes in this folder.

  • inc - Page parts that are included in a template, like header, footer, navigation etc...
  • layouts- Templates that are extended by the pages.

In the root of the views is where the pages are located.

Notes:

If the project hasn't been generated by Maverick CLI commands (scss, pug) won't work.

maverick-cli's People

Contributors

ilicmarko avatar renovate-bot avatar

Stargazers

 avatar

Watchers

 avatar  avatar

maverick-cli's Issues

Dependency Dashboard

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

Warning

These dependencies are deprecated:

Datasource Name Replacement PR?
npm babel-preset-es2015 Unavailable
npm istanbul Unavailable

Rate-Limited

These updates are currently rate-limited. Click on a checkbox below to force their creation now.

  • chore(deps): update dependency chai-as-promised to v7.1.2
  • chore(deps): update dependency browser-sync to v3
  • chore(deps): update dependency chai to v5
  • chore(deps): update dependency chai-as-promised to v8
  • chore(deps): update dependency del to v7
  • chore(deps): update dependency gulp to v5
  • chore(deps): update dependency gulp-autoprefixer to v9
  • chore(deps): update dependency gulp-filter to v9
  • chore(deps): update dependency gulp-imagemin to v9
  • chore(deps): update dependency gulp-size to v5
  • chore(deps): update dependency mocha to v10
  • fix(deps): update dependency chalk to v5
  • fix(deps): update dependency commander to v12
  • fix(deps): update dependency execa to v9
  • fix(deps): update dependency fs-extra to v11
  • 🔐 Create all rate-limited PRs at once 🔐

Edited/Blocked

These updates have been manually edited so Renovate will no longer make changes. To discard all commits and start over, click on a checkbox.

Open

These updates have all been created already. Click a checkbox below to force a retry/rebase of any.

Ignored or Blocked

These are blocked by an existing closed PR and will not be recreated unless you click a checkbox below.

Detected dependencies

npm
package.json
  • chalk ^2.4.2
  • co ^4.6.0
  • co-prompt ^1.0.0
  • commander ^2.20.3
  • execa ^1.0.0
  • fs 0.0.2
  • fs-extra ^7.0.0
  • listr ^0.14.0
  • path ^0.12.7
  • slugify ^1.3.6
  • chai ^4.2.0
  • chai-as-promised ^7.1.1
  • chai-fs ^2.0.0
  • coveralls ^3.0.9
  • istanbul ^0.4.5
  • mocha ^4.1.0
structure/package.json
  • babel-core 6.26.3
  • babel-preset-es2015 6.24.1
  • babel-register 6.26.0
  • browser-sync 2.26.3
  • del 4.0.0
  • gulp 4.0.0
  • gulp-autoprefixer 6.0.0
  • gulp-babel 6.1.3
  • gulp-cache 0.5.0
  • gulp-cssnano 2.1.3
  • gulp-eslint 3.0.1
  • gulp-filter 4.0.0
  • gulp-htmlmin 3.0.0
  • gulp-if 2.0.2
  • gulp-imagemin 3.4.0
  • gulp-load-plugins 1.5.0
  • gulp-plumber 1.2.1
  • gulp-pug 3.3.0
  • gulp-sass 2.3.2
  • gulp-size 2.1.0
  • gulp-sourcemaps 2.6.5
  • gulp-uglify 2.1.2
  • gulp-useref 3.1.6
  • main-bower-files 2.13.1
  • run-sequence 1.2.2
  • wiredep 4.0.0
  • node >=4
travis
.travis.yml
  • node 8
  • node 6

  • Check this box to trigger a request for Renovate to run again on this repository

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.