design8383 / semantic-ui

Semantic is a UI component framework based around useful principles from natural language.

Semantic UI

Semantic is a highly-themable UI framework with naming conventions built around common usage.

Key Features

• 50+ UI Elements
• 3000 + CSS Variables
• 3 Levels of Variable Inheritance (Similar to SublimeText)
• Built using EM values for responsive design

Semantic UI is now at 1.0, be sure to check out our release notes for changes from the pre-release.

Semantic now uses Slack for project discussions. Request an Invite to join the discussion.

Community contributed plugins and ports for Wordpress, Angular, Dart, Knockout, Rails, and more can be found on the Integration page.

Translations

Translations are available directly in the docs, using the language toolbar.

Getting Started

Semantic is best used actively during development. We have included build tools for maintaining changes to Semantic as you work.

npm install
gulp

Running gulp for the first time will start the interactive set-up.

This helps you create two important files semantic.json which stores your folder set-up, and themes.config a central file for setting ui themes.

The install utility will also help you set-up which components you want to include in your packaged release, ignoring parts of Semantic you may not use.

Once set-up you can use these commands to maintain your project

gulp  // defaults to watch after install
gulp build // build all files from source
gulp clean // clears your dist folder
gulp watch // watch files
gulp install // re-runs install
gulp help // list all commands

Bugs and Issues

Semantic UI is production ready, but is "pre-release" until build and theming tools are available, and documentation is complete for all components.

Please share any issues you may have. We need your help to get all the kinks out.

If you are reporting a bug you must create a test-case. You can fork this jsfiddle to get you started.

If you need help, come hang out in #semantic-ui on irc.freenode.net. Click here to use webchat.

Browser Support

• Last 2 Versions FF, Chrome, IE (aka 10+)
• Safari 6
• IE 9+ (Browser prefix only)
• Android 4
• Blackberry 10

Reaching Out

If you'd like to start a conversation about Semantic feel free to reach out by e-mail [email protected]