Name Picker Malfunction

    ember-freestyle

    0.14.0 • Public • Published

    Ember Freestyle

    Build Status

    NPM Version Download Count All Time Ember Observer Score Conventional Commits

    All Contributors

    Ember Freestyle is an Ember addon that allows you to quickly create a component explorer for your Ember app.

    Documentation

    This README provides a lightweight overview of Ember Freestyle to get you going. More complete documentation can be found at https://chrislopresto.github.io/ember-freestyle.

    Live Demo

    To see Ember Freestyle in action, visit https://chrislopresto.github.io/ember-freestyle/#/acceptance.

    Compatibility

    • Ember.js v3.16 or above
    • Ember CLI v3.16 or above
    • Node.js v12 or above
    • Ember Auto Import v2 or above

    Installation

    This installation process is opinionated in order to get you going quickly.

    1. ember install ember-freestyle

      This will do the following:

      • Install the ember-freestyle addon itself
      • Add a freestyle template in your app
      • Add a freestyle controller in your app
    2. Add this.route('freestyle'); to your app/router.js file

    3. Navigate to /freestyle. You should now see something like:

    All of the generated output is optional. If you don't want a freestyle route, for example, feel free to get rid of it and add a freestyle-guide somewhere else in your app.

    You can use the freestyle-guide component anywhere you'd like in your app. You can organize your components into multiple Freestyle guides if you want to. You can even use the constituent components like freestyle-usage on their own.

    Problems? No problem.

    Hopefully the installation instructions got you off to a smooth, seamless start. If you have any problems, feel free to chat with us in the Ember Community Discord or open an issue. As always, PRs are welcome!

    Excluding Ember Freestyle's Styles

    If you want to exclude Ember Freestyle's styles, you can set the includeStyles option to false in your ember-cli-build.js file:

    // ember-cli-build.js
    
    module.exports = function (defaults) {
      const app = new EmberApp(defaults, {
        'ember-freestyle': {
          includeStyles: false,
        },
      };
    };

    This might be useful in case you want to define your own styles or if you are using ember-cli-sass and want to import Ember Freestyle's styles explicitly:

    $FreestyleGuide-color--primary: #C70039;
    $FreestyleGuide-color--accent: #DAF7A6;
    
    @import 'ember-freestyle';

    Excluding Ember Freestyle from Your Production Build

    We recommend excluding Ember Freestyle from production builds using Ember CLI's addons.blacklist option.

    // ember-cli-build.js
    
    const environment = process.env.EMBER_ENV;
    const addonsToExclude = environment === 'production' ? ['ember-freestyle'] : [];
    
    module.exports = function (defaults) {
      const app = new EmberAddon(defaults, {
        addons: {
          blacklist: addonsToExclude,
        },
      };
    };

    Using Ember Freestyle Within an Addon

    You should include ember-freestyle in your devDependencies so that apps using your addon will not include Ember Freestyle CSS and JavaScript in their production builds.

    Contributing

    See the Contributing guide for details.

    Contributors

    Thanks goes to these wonderful people (emoji key):


    Chris LoPresto

    💻 📖 ⚠️

    Luke Melia

    💻 📖 ⚠️

    Andrew Fan

    💻

    Chris van der Ploeg

    💻 📖

    Ilya Radchenko

    💻 📖

    Mike Szörnyi

    💻 📖

    miguel barcos

    ⚠️

    Nathan Ward

    💻 📖

    zidjian257

    💻 ⚠️

    Eli Dupuis

    💻

    Peter Wagenet

    💻

    Sivakumar Kailasam

    💻

    Manuel Wiedenmann

    💻

    Lucas Hill

    💻

    Alex Zlotnik

    💻

    Tamzin Blake

    💻

    Simon Ihmig

    📖

    Ryan Tablada

    💻

    Kerrick Long

    💻

    Hajdukovic Radovan

    💻 📖

    Rob

    💻

    Gijs Boddeus

    💻

    Sarah Canieso

    💻

    Brian Runnells

    💻

    Dan Wenzel

    💻 ⚠️

    Camille TJHOA

    💻 📖

    Michael Swanson

    ⚠️

    Sam Van Campenhout

    📖

    Chris Krycho

    💻

    Will Bagby

    💻 ⚠️

    Noah

    💻

    Stanley Stuart

    💻

    Matt McManus

    💻

    Suzi Dao

    💻 ⚠️

    Ray Tiley

    💻

    lucasmerat

    💻

    Kit

    💻

    Andrey Mikhaylov (lolmaus)

    🐛 💻

    Bert De Block

    💻 🤔

    This project follows the all-contributors specification. Contributions of any kind are welcome!

    License

    This project is licensed under the MIT License.

    Keywords

    Install

    npm i ember-freestyle

    DownloadsWeekly Downloads

    12,980

    Version

    0.14.0

    License

    MIT

    Unpacked Size

    125 kB

    Total Files

    118

    Last publish

    Collaborators

    • lukemelia
    • chrislopresto