‼️	This repository is no longer actively maintained. The theme still works, but does not receive any further updates other than community contributed fixes. Check our flagship WordPress starter theme air.

dudestarter -- A WordPress starter theme

This is a WordPress theme for starting new projects used by Digitoimisto Dude Oy. It's heavily based on Automattic's Underscores. The goal is to get feature rich theme for developers, but not bloated in any way.

Table of contents

1. Please note before using
2. License
3. Features
   1. Layout base & grid
   2. Typography
   3. Development
   4. Navigations included
   5. Forms
   6. Effects
   7. WordPress & functions
   8. Integrations
4. What's left out from Underscores
5. Requirements
6. Usage
7. Contributing

Please note before using

Dudestarter is a development theme, so it has updates very often. By using this starter theme, you agree that the fonts can change, layout can change, everything can change, and they will, without a warning. Version 1 looked quite different than version 3. It was like a different theme. After all, this is a development theme for Dude's personal preferences and principles.

Dudestarter is not meant to be "a theme for everyone", so it doesn't have customizers (wp-admin options), easy functions, separated theme parts (except template-parts) or any specifically easy to use stuff. This is now open-sourced, but includes a lot of custom stuff that will not work out of the box.

If you for some crazy 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. This is just a plain skeleton and nothing else. I recommend using Underscores or Sage if you need something more complete.

License

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.

Features

Layout base & grid

• All good things from the latest Underscores
• Tiny bits and pieces, (the good) parts from Bootstrap 3.1.1
• SASS-support (SCSS-syntax)
• CSS reset with a combination with Nicolas Gallagher's normalize*css and (optionally) Jonathan Neal's sanitize.css
• Jeet Grid for SASS @include col(1/100)
• Parts from Outline
• Miscellaneous custom dudemixins

Typography

• Scalable and responsive typography with font stacks: Typographic
• Google Webfonts with Penman's Sass-Web-Fonts and custom web fonts with Sass Boilerplate's fontFace-mixin
• REM units with pixel fallback: sass-rem @include rem('padding', '10px)
• Font-Awesome Glyph icons

Development

• 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)
• Bower for front-end package management (see Dude's devpackages)

Navigations included

• Flexnav-rolle - A jQuery plugin for responsive menus
• Trunk.js - A responsive web design to hide top navigation into a navigation drawer on Tablets and Mobile Phones

Forms

• Buttons - A CSS button library built using Sass and Compass

Effects

• saffron - A simple Sass mixin library for animations and transitions

• Animate.css - A cross-browser library of CSS animations. As easy to use as an easy thing.

WordPress & functions

• Tommcfarlin's separated comments and pingbacks
• Don't count pingbacks or trackbacks when determining the number of comments on a post
• Multilingual ready
• All times and local units in Finnish
• More accurate time in WP Last Login
• Uploads folder: www.yoursite.com/media instead of www.yoursite.com/content/uploads
• Default pages automatically selected for Front Page and blog home
• Hiding things customers won't usually need
• Automatic Feed Links in head
• Enable support for Post Thumbnails on posts and pages
• Editable navigation menus, custom dude navigation walker
• Disabled WordPress Admin Bar

Integrations

• Dude's custom Facebook SDK for Facebook feeds
• Google Maps (Javascript API) for contact page

What's left out from Underscores

Mostly not needed, because customizing so much stuff per project. (Don't Repeat Yourself mentality, noticed no need in projects and always have to remove anyway)

• Custom Header feature
• Template tags (except archives and post navigation, of course)
• Customizer additions
• Widgets
• No comments template on pages by default
• Right to left (RTL)

Requirements

• Mac OS X (development only - not tested on other systems, but feel free to try and report back)
• Devpackages - Npm, Gulp and Bower
• Dudestack - A toolkit for creating a new professional WordPress project with deployments. Heavily based on Bedrock by Roots.

Usage

Go through Dudestack Instructions to install vagrant development environment and dudestack. Then:

1. Clone this repository and unpack it to your project folder (or under test directory, for example for us it's ~/Projects/dudetest/content/themes/dudestarter)
2. Edit STARTERTHEMEPATH to point out to dudestarter in newtheme.sh
3. Run newtheme.sh (requires Dudestack's createproject command to be run before)
4. Go to Projects folder and run npm install
5. Run gulp watch in project-folder
6. Start with sass/base/config.scss and continue editing from there. The main CSS file will always be sass/base/layout.scss.

Contributing

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.