1 | ![Fomantic Logo](http://fomantic-ui.com/images/logo.png#128)
|
2 |
|
3 | # Fomantic UI
|
4 | A community fork of the popular Semantic-UI framework
|
5 |
|
6 | [![Build Status](https://travis-ci.org/fomantic/Fomantic-UI.svg?branch=master)](https://travis-ci.org/fomantic/Fomantic-UI)
|
7 | [![Discord Server](https://img.shields.io/discord/453127116427493376.svg?label=Discord)](https://discord.gg/YChxjJ3)
|
8 | [![npm downloads](https://img.shields.io/npm/dw/fomantic-ui.svg?label=npm%20downloads)](https://www.npmjs.com/package/fomantic-ui)
|
9 | [![npm version](https://img.shields.io/npm/v/fomantic-ui.svg)](https://www.npmjs.com/package/fomantic-ui)
|
10 | [![last commit](https://img.shields.io/github/last-commit/fomantic/Fomantic-UI/develop.svg)](https://github.com/fomantic/Fomantic-UI/commits/develop)
|
11 | [![jsdelivr](https://data.jsdelivr.com/v1/package/npm/fomantic-ui/badge?style=rounded)](https://www.jsdelivr.com/package/npm/fomantic-ui)
|
12 | [![Package Quality](https://npm.packagequality.com/shield/fomantic-ui.svg)](https://packagequality.com/#?package=fomantic-ui)
|
13 |
|
14 | ---
|
15 |
|
16 | > *NOTE:* Fomantic was created to continue active development of Semantic-UI and has the intent to be merged back into the master repository once active development can restart. For more info please read the following issues https://github.com/Semantic-Org/Semantic-UI/issues/6109 https://github.com/Semantic-Org/Semantic-UI/issues/6413
|
17 | >
|
18 | > *EDIT:* Lots has changed since we started this project and we are now starting the development of FUI v3. You can read more about the > v3 proposals [here](https://github.com/fomantic/Fomantic-UI/issues/319).
|
19 | >
|
20 | > To be clear merging back into SUI is still our intention, read [this comment](https://github.com/fomantic/Fomantic-UI/issues/319#issuecomment-461736399) for more info
|
21 |
|
22 | ---
|
23 |
|
24 | Fomantic allows developers to build beautiful websites fast, with **concise HTML**, **intuitive javascript**, and **simplified debugging**, helping make front-end development a delightful experience. Fomantic is responsively designed allowing your website to scale on multiple devices.
|
25 |
|
26 | ## 📡 Installation
|
27 |
|
28 | ```bash
|
29 | $ npm install fomantic-ui --save
|
30 | ```
|
31 |
|
32 | Fomantic UI includes an interactive installer to help setup your project.
|
33 |
|
34 | * For more details on setup visit our [getting started guide](http://fomantic-ui.com/introduction/getting-started.html).
|
35 | * To learn more about theming please read our [theming guide](http://fomantic-ui.com/usage/theming.html)
|
36 |
|
37 | ### 💻 Browser Support
|
38 |
|
39 | * Last 2 Versions FF, Chrome, Safari Mac
|
40 | * IE 11+
|
41 | * Android 4.4+, Chrome for Android 44+
|
42 | * iOS Safari 7+
|
43 | * Microsoft Edge 12+
|
44 |
|
45 | Although some components will work in IE9, [grids](http://semantic-ui.com/collections/grid.html) and other [flexbox](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Flexible_boxes) components are not supported by IE9 and may not appear correctly.
|
46 |
|
47 | ## 💬 Community
|
48 |
|
49 | ### 💡 Getting Help
|
50 |
|
51 | If you have a usage question please **do not post** post it to GitHub Issues. You can ask for usage help via our [Discord](https://discord.gg/YChxjJ3) server.
|
52 | Please only create Github issues for bug's and feature requests or any other related issue.
|
53 |
|
54 | ### 🐛 Submitting Bugs and Enhancements
|
55 | [GitHub Issues](https://github.com/fomantic/Fomantic-UI/issues) is for suggesting enhancements and reporting bugs. Before submitting a bug make sure you do the following:
|
56 | * Check to see if the issue has already been raised.
|
57 | * [Fork this boilerplate JSFiddle](https://jsfiddle.net/31d6y7mn) to create a test case for your bug. If a bug is apparent in the docs, that's ok as a test case, just make it clear exactly how to reproduce the issue. Only bugs that include a test case can be triaged.
|
58 | * If submitting an enhancement try and create it in the [JSFiddle](https://jsfiddle.net/31d6y7mn) if not it's fine but explain clearly what you want.
|
59 |
|
60 | ### 📝 Pull Requests
|
61 |
|
62 | Before creating a pull request be sure to read the [contributing](CONTRIBUTING.md) guide, this is where we explain everything you need to know about contributing to Fomantic-UI.
|
63 |
|
64 | ## Sponsors
|
65 |
|
66 | #### Cross-browser testing provided by [BrowserStack](https://www.browserstack.com)
|
67 | [![BrowserStack](https://cdn.rawgit.com/fomantic/Fomantic-UI-Docs/35180e95/server/raw/images/browserstack.png)](https://www.browserstack.com)
|
68 |
|
69 | #### IDE's provided by [JetBrains](https://www.jetbrains.com?from=Fomantic-UI)
|
70 | [![JetBrains](https://fomantic-ui.com/images/jetbrains.svg)](https://www.jetbrains.com?from=Fomantic-UI)
|
71 |
|
72 | ---
|
73 |
|
74 | #### Credit
|
75 | Semantic-UI was beautifully crafted by [@jlukic](https://github.com/jlukic)
|