Code Monkey home page Code Monkey logo

jekyons's Introduction

jekyons

Stop writing CSS and start building prototypes.

huh?

Jekyons is a starting point you can use to build Very Good prototypes with Jekyll (a powerful static site generator) and Tachyons (a life-changing functional CSS library). A few friends asked to check out my prototyping stack so I cleaned it up a little bit and here we are. I've already fumbled around integrating cool stuff like BrowserSync (actual magic) and 18F's jekyll-get plugin so you don't have to.

why do I care?

GR8 question. Writing CSS is hard. Maintaining CSS across a team of developers and multiple projects is absolutely impossible. That makes prototyping, something that should feel natural in concept, a real bummer in practice. The power of Jekyll templating and the maintainability of Tachyons is the closest I've come to solving that problem.

Still don't get it? For example, take the list of features on the Jekyons website. Responsive columns, multiple repeating elements in each bucket, images; this could easily amount to over 50 lines of HTML and possibly even more CSS. With Jekyll & Tachyons, I was able to design & build it in ~20 minutes with less than 10 lines of code total:

<div class="ma4 ma5-ns">
  {% for feature in site.data.features %}
  <div class="w-33-l pr4 mb5 fl-l mt4 cf-4th p-fix">
    <img class="w2" src="{{ feature.icon }}">
    <h2 class="normal">{{ feature.name }}</h2>
    <p class="lh-copy f5">{{ feature.description }}</p>
  </div>
  {% endfor %}
</div>

DAMN Y'ALL. If you don't think that's cool you can LEAVE.

ok, how?

git clone https://github.com/tinychime/jekyons.git your-project
cd your-project
npm install
bundle install
jekyll build
gulp

This is very in alpha, so if you have any trouble with the steps above, let me know on Twitter!

jekyons's People

Contributors

hacknug avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar

jekyons's Issues

clearfix

you may want to put the tachyons "cf" after the list of features vs. after the blurb at the bottom as the cf sticks an ::after on whatever block element it's applied to so the clearfix is coming after the blurb at the bottom instead of after the feature blocks...

Ps. this is cool so I ported it over to Hugo... which I'm sorta using instead of Jekyll now for prototyping and a few customer live sites due to how fast it is (messing with large sites in jekyll is not at all fun when refactoring/messing with design and waiting for the browser refresh (also deploys CRAZY fast on netlfy etc)

Browser-sync serves before build is complete

This only seems to be an issue when starting with a fresh Jekyons clone, but browser-sync seems to serve the site a few seconds before it's actually done building resulting in a 'Cannot GET /' error at localhost. A few seconds later, it finishes building but you then have to manually reload the browser to preview changes. If you kill gulp and re-run, it works as expected.

You should be able to reproduce by cloning a new Jekyons project, installing dependencies and running 'gulp'.

Tachyons via cdn?

hey, thanks @joshosbrn for making this and sharing with the whole wide world!!

it's pretty super great.

just curious, why'd you opt to include Tachyons via cdn and not npm?

thanks!

feature block arrangement

Any idea why the front page feature blocks fail to line up in order if you list more than six features in features.yml? The blocks arrange themselves with gaps. See for instance: https://gwijthoff.github.io/jekyons-test/

This may have something to do with the tachyons clearfix in index.html but I'm not sure.

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.