deester4x4jr / flo-theme-2017 Goto Github PK

Air is designed to be a minimal starting point for a WordPress project at Digitoimisto Dude Oy, a Finnish boutique digital agency in the center of Jyväskylä. Theme is based on _s.

• CSS gzipped: 6.2 KB (27.6 KB original)
• JS gzipped: 3.5 KB (11.1 KB original)
• Front page HTML: 7.4 KB (29.4 KB original)

This theme is built to be very straightforward, front end developer friendly and only partly modular by its structure.

1. Please note before using
2. License
3. Features
   1. Layout base & grid
   2. Typography
   3. Development
   4. Navigation
   5. WordPress & functions
   6. Disabled features
   7. WooCommerce support
4. Requirements
5. Recommendations for development
6. Installation
7. Contributing
8. Notes

Air is a development theme, so it has updates very often. By using this starter theme, you agree that the anything can change to a different direction without a warning.

Air is not meant to be "a theme for everyone", so it doesn't have many parts that are generally included (see Disabled features).

If you for some reason happen to use this theme as base, please note the theme won't necessarily be that much fun or won't necessarily look any good. I recommend using Sage if you need something more complete.

Dudestarter is licensed with The MIT License (MIT) which means you can freely use this theme commercially or privately, modify it, or distribute it, but you are forbidden to hold Dude liable for anything, or claim that what you do with this is made by us.

• All good things from the latest Underscores
• SASS-support (SCSS-syntax)
• CSS reset with a combination with Nicolas Gallagher's normalize*css
• Jeet Grid for SASS @include column(1/100)
• Container div inside site-main
• Possible to choose between fluid (flexible 100%) and snappy grid style (snapping to breakpoint, more space around)
• Inline SVG-ready

• Responsive typography with viewport units with fallbacks (formerly Megatype, still recommended with blogs or text-only based sites, but not included by default after 1.5.0)
• Google Webfonts with Penman's Sass-Web-Fonts
• Web fonts helper: Sass Boilerplate's fontFace-mixin (if you have .odt, .ttf, .woff, .woff2 in fonts directory, you can add them with @include fontFace('Proxima Nova', '../fonts/proximanova-regular-webfont', 400);)

• BrowserSync for keeping multiple browsers and devices synchronized while testing, along with injecting updated CSS and JS into your browser while you're developing (included in devpackages)
• gulp build script that compiles both Less and Sass, checks for JavaScript errors, optimizes images, and concatenates and minifies files (see Dude's devpackages)
• npm for front-end package management

• Custom navigation walker based on Bootstrap 3
• Sassified version of viljamis' responsive-nav, fully Accessible and responsive multi-level navigation

• Available for translation
• Automatic feed links
• WordPress managed title tag
• Support for Post Thumbnails on posts and pages
• HTML5 core markup for WordPress elements
• WP updates nag hidden
• All times and local units in Finnish
• Custom uploads folder media/ instead of default content/uploads/
• Air specific: Templates for hero slides

• Widgets
• Post formats
• Jetpack support
• Customizer
• RTL support
• Threaded comments
• Template tags (direct edit preferred)
• WordPress admin bar for logged in users
• No sidebar by default
• Emojicons

Air has by default basic WooCommerce support from version 1.9.2. It includes the most basic overrides like buttons. WooCommerce as well as other things in the theme are built for starting point only.

• Requires at least: WordPress 4.7.0
• Tested up to WordPress 4.7.0

• Mac OS X
• Devpackages - Npm, Gulp and Bower
• Dudestack - A toolkit for creating a new professional WordPress project with deployments. Heavily based on Bedrock by Roots.

Traditional way:

1. Git clone or download zip
2. Open Terminal and run npm install
3. Open project to Atom (or your preferred editor) and run search and replace air => yourprojectname
4. Run gulp watch and start coding

If you are using Dudestack and Devpackages, your project folder is located at ~/Projects, your vagrant box is up and running at 10.1.2.4, just

1. Open Terminal and cd to air directory
2. Run sh newtheme.sh - the script takes care of the rest (updates textdomain with your project name, checks updates for air and npm packages, runs npm install, fetches devpackages, sets up gulp, cleans up the leftover files and activates the theme via wp-cli)

If you have ideas about the theme or spot an issue, please let us know. Before contributing ideas or reporting an issue about "missing" features or things regarding to the nature of that matter, please read Please note section. Thank you very much.

Gzip file sizes tested with wc -c css/global.css and gzip -c css/global.css | wc -c commands.