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.

Community Support

Want to learn about Semantic? Request an Invite to join our Slack chatroom for support and project discussions
Have a bug? Make a test case by forking this jsfiddle, then submit a bug on GitHub
Having issues with your code? Join our IRC chat, submit a question on StackOverflow or ask our Google Group
Looking for a specific integration like Dart, Wordpress, Angular, or Rails? Check out our integration page

Contributing

Missing documentation in your language? Help us make Semantic available in more languages by joining our translation community
Want to help with integration? Projects are organizing for official Meteor, and Angular integrations as well as a SASS port. Join the discussion on their respective boards.
Want to help others learn concepts behind Semantic? Learnsemantic.com needs articles to help others get others up to speed with Semantic UI. Send me an e-mail if you are interested.

Getting Started

Vanilla Distribution

We recommend setting up the Semantic build workflow to support on-the-fly theming and customization, but it is not required.

To use the "vanilla" Semantic build, which includes all components, simply use dist/semantic.js and dist/semantic.css (or their minified counterparts) from this repository in your project.

These two files are the output of the build process, and they are the only files that must be served to the browser to make use of Semantic UI.

Custom Build

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

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 jack@semantic-ui.com

4.0 KiB Raw Blame History