JavaScript Other
Permalink
Failed to load latest commit information.
.circleci chore(circleci): fix typo in a step name (#2200) Oct 17, 2017
.github docs(ISSUE_TEMPLATE): update link to SO and code template (#2198) Oct 16, 2017
browser docs(Views): add <meta name="viewport"> tags to docs (#2231) Oct 29, 2017
build chore(debug): remove debug from builds (#2058) Sep 11, 2017
docs Fix(typo): Rectifiying spelling in the examples (#2426) Jan 12, 2018
examples docs(examples): fix webpack.config.js (#2171) Oct 8, 2017
gulp chore(docgen|menugen): fix problems with paths on Windows (#2349) Dec 3, 2017
src fix(Responsive): use setState() safely (#2421) Jan 11, 2018
test feat(Confirm): allow custom sizes (#2409) Jan 10, 2018
.babelrc chore(package): switch to react-hot-loader (#1946) Aug 13, 2017
.editorconfig Add Circle CI badge to README Dec 20, 2015
.eslintignore Remove console.group* usage (#273) Jun 23, 2016
.eslintrc fix(lint): disable newline-per-chained-call Aug 20, 2017
.gitignore docs(ComponentSidebar): add sidebar navigation (#2070) Nov 25, 2017
CHANGELOG.md docs(changelog): update changelog [ci skip] Jan 10, 2018
LICENSE.md chore(LICENSE): add MIT license Aug 16, 2016
README.md docs(README): add Cryptact to the built with list (#2413) Jan 8, 2018
codecov.yml chore(coverage): remove docs from coverage reports (#1283) Feb 5, 2017
config.js chore(package): update to react 16 (#2131) Oct 10, 2017
gulpfile.babel.js chore(package): update all dependencies (#1895) Aug 20, 2017
index.d.ts feat(Pagination): add new component (#2352) Jan 10, 2018
karma.conf.babel.js docs(HOC): remove reexport to avoid warning in test (#2270) Oct 29, 2017
package.json 0.77.2 Jan 10, 2018
tsconfig.json test(typings): add rendering test (#1625) May 6, 2017
tslint.json chore(package): Add ts-lint for typings (#1156) Jan 17, 2017
webpack.config.babel.js chore(package): update all dependencies (#1895) Aug 20, 2017
webpack.dll.js chore(package): update all dependencies (#1895) Aug 20, 2017
webpack.umd.config.js chore(package): update all dependencies (#1895) Aug 20, 2017
yarn.lock chore(package): update yarn.lock Nov 25, 2017

README.md

Semantic UI React

Gitter Circle Codecov David npm

Hey, we're in development. Prior to reaching v1.0.0:

  1. MINOR versions represent breaking changes
  2. PATCH versions represent fixes and features
  3. There are no deprecation warnings between releases
  4. You should consult the CHANGELOG and related issues/PRs for more information

Installation & Usage

See the Documentation for an introduction, usage information, and extensive examples.

Built With Semantic UI React

These great products are built on Semantic UI React. Add yours here.

Example Projects

This is a listing of example projects and guides that will help you integrate Semantic UI React into your new or existing projects.

webpack1

Our example project right here in this repo.

webpack2

Our example project right here in this repo.

SUIcrux

Advanced universal starter with Semantic-UI-React. React/Redux/Lazy-loading/SSR/PWA.

semantic-ui-react-todos

This example modifies the well-known react-redux Todo List to use Semantic UI components. There is also a write-up on the process in the project README.

FAQ

Can I use custom Icons?

Yes. Just use <Icon className='my-icon' /> instead of <Icon name='my-icon' />. See https://github.com/Semantic-Org/Semantic-UI-React/issues/931#issuecomment-263643210 for detailed info and examples.

How do I setup CSS?

There are several options. Refer to our doc on CSS Usage.

Can I use a custom CSS theme?

Yes. Semantic UI React includes components that render valid Semantic UI HTML, no CSS is included. This allows you to load any Semantic UI CSS theme on top of your Semantic UI React app.

Here are some helpful links:

Voice Your Opinion

Help shape this library by weighing in on our RFC (request for comments) issues.

How Can I Help?

Our CONTRIBUTING.md is a step-by-step setup and development guide. It is meant to be read from top to bottom. Once you're up to speed, each issue here includes more information on how you can help:

Good First Issue

Issues labeled good first issue are a great way to ease into development on this project.

Missing Components

We're seeking component parity with Semantic UI, plus some addons. There is an issue for every missing component, labeled new component. Just comment on the issue you'd like to take.

Help Wanted Label

Any other issue labeled help wanted is ready for a PR.

100% Semantic UI Support

Elements Collections Views Modules Behaviors
✓ Button ✓ Breadcrumb ✓ Advertisement ✓ Accordion Form Validation
✓ Container ✓ Form ✓ Card ✓ Checkbox API (NA)
✓ Divider ✓ Grid ✓ Comment ✓ Dimmer ✓ Visibility
✓ Flag ✓ Menu ✓ Feed ✓ Dropdown
✓ Header ✓ Message ✓ Item ✓ Embed
✓ Icon ✓ Table ✓ Statistic ✓ Modal
✓ Image ✓ Popup
✓ Input ✓ Progress
✓ Label ✓ Rating
✓ List ✓ Search
✓ Loader Shape
✓ Rail ✓ Sidebar
✓ Reveal ✓ Sticky
✓ Segment ✓ Tab
✓ Step ✓ Transition

Principles

  • No jQuery dependency
  • No animation dependencies
  • Reuse SUI CSS transitions
  • Simple declarative component APIs vs intricate HTML markup
  • Complete keyboard support
  • Complete SUI component definition support
  • Completely documented
  • Completely tested

Releasing

On the latest clean master:

yarn release:major
yarn release:minor
yarn release:patch

Releasing will update the changelog which requires github_changelog_generator.

Credit

Originally made for @TechnologyAdvice by @levithomason.

Big thanks to our contributors, especially:

  • @layershifter for essentially taking over during @levithomason's unavailability
  • @jcarbo for thoughtful engineering
  • @jamiehill for early engineering and support