Skip to content

Commit

Permalink
Merge pull request #16 from samundrak/master
Browse files Browse the repository at this point in the history
Add Category "Frameworks" with UI libraries and frameworks
  • Loading branch information
David Boyne committed Feb 15, 2019
2 parents c4b96e3 + 1351732 commit 534678a
Show file tree
Hide file tree
Showing 31 changed files with 2,413 additions and 1 deletion.
3 changes: 3 additions & 0 deletions gatsby-config.js
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,9 @@ module.exports = {
Examples: {
subtitle: 'Explore example applications',
},
Frameworks: {
subtitle: 'React UI Component Frameworks',
},
},
},
plugins: [
Expand Down
3 changes: 2 additions & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,8 @@
"add:boilerplate": "node src/scripts/create-material/index.js Boilerplates",
"add:router": "node src/scripts/create-material/index.js Routing",
"add:form": "node src/scripts/create-material/index.js Forms",
"add:lib": "node src/scripts/create-material/index.js Libraries"
"add:lib": "node src/scripts/create-material/index.js Libraries",
"add:framework": "node src/scripts/create-material/index.js Frameworks"
},
"devDependencies": {
"babel-jest": "^24.1.0",
Expand Down
38 changes: 38 additions & 0 deletions src/components/Category/__snapshots__/spec.js.snap
Original file line number Diff line number Diff line change
Expand Up @@ -266,6 +266,44 @@ exports[`Category when the name prop is set to "Forms is reads the siteConfig an
</div>
`;

exports[`Category when the name prop is set to "Frameworks is reads the siteConfig and uses the configured icon and subtitle 1`] = `
<div
className="category-container column is-one-third"
>
<div
className="category"
onClick={[Function]}
>
<img
alt="icon"
src="test-file-stub"
/>
<h2
className=" has-text-centered"
>
Frameworks
</h2>
<div
className="category-content"
>
<div
className="media"
>
<div
className="media-content"
>
<p
className="subtitle is-6"
>
React UI Component Frameworks
</p>
</div>
</div>
</div>
</div>
</div>
`;

exports[`Category when the name prop is set to "Integration is reads the siteConfig and uses the configured icon and subtitle 1`] = `
<div
className="category-container column is-one-third"
Expand Down
2 changes: 2 additions & 0 deletions src/icons/ui-frameworks.svg
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
136 changes: 136 additions & 0 deletions src/materials/Frameworks/OnsenUI/OnsenUI.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,136 @@
---
path: '/materials/OnsenUI'
type: 'GitHub'
img: './screenshot.png'
material:
title: 'OnsenUI'
url: 'https://onsen.io/'
github_url: 'https://github.com/OnsenUI/OnsenUI'
subscribers_count: '340'
stargazers_count: '7236'
tags: ['android','angular','cordova','customelements','html','hybrid-apps','ios','javascript','material','monaca','onsen-ui','pwa','react','vue','webcomponents']
subtitle: 'Mobile app development framework and SDK using HTML5 and JavaScript. Create beautiful and performant cross-platform mobile apps. Based on Web Components, and provides bindings for Angular 1, 2, React and Vue.js.'
clone_url: 'https://github.com/OnsenUI/OnsenUI.git'
ssh_url: 'git@github.com:OnsenUI/OnsenUI.git'
pushed_at: '2019-01-22T22:08:29Z'
updated_at: '2019-02-14T15:05:02Z'
author:
name: 'OnsenUI'
avatar: 'https://avatars3.githubusercontent.com/u/5972822?v=4'
github_url: 'https://github.com/OnsenUI'
latestRelease:
tag_name: '2.10.6'
name: '2.10.6'
url: 'https://github.com/OnsenUI/OnsenUI/releases/tag/2.10.6'
created_at: '2018-11-30T17:42:35Z'
---

<p align='center'><a href='https://onsen.io/' target='_blank'><img width='140' src='https://onsenui.github.io/art/logos/onsenui-logo-1.png'></a></p>

<p align='center'>
<a href='https://community.onsen.io/'><img src='https://img.shields.io/badge/forum-onsen--ui-FF412D.svg' alt='Forum'></a>
<a href='https://github.com/OnsenUI/OnsenUI/blob/master/core/src/onsenui.d.ts'><img src='http://definitelytyped.org/badges/standard.svg' alt='TypeScript definitions'></a>
<br>
<a href='https://circleci.com/gh/OnsenUI/OnsenUI'><img src='https://circleci.com/gh/OnsenUI/OnsenUI.svg?style=shield' alt='Circle CI'></a>
<a href='https://badge.fury.io/js/onsenui'><img src='https://badge.fury.io/js/onsenui.svg' alt='NPM version'></a>
<a href='https://cdnjs.com/libraries/onsen'><img src='https://img.shields.io/cdnjs/v/onsen.svg' alt='CDNJS'></a>
</p>

# [Onsen UI](https://onsen.io/) - Cross-Platform Hybrid App and PWA Framework

Onsen UI is an <strong>open source</strong> framework that makes it easy to create native-feeling Progressive Web Apps (PWAs) and hybrid apps.

The core library is written in <strong>pure Javascript</strong> (on top of <a href='http://webcomponents.org/'>Web Components</a>) and is <strong>framework agnostic</strong>, which means you can use it with your favorite framework and its tools. We provide some extra binding packages to make it easy to use Onsen UI's API with many popular frameworks:

<table>
<tbody><tr>
<td align='center' width='150'><a href='https://onsen.io/react'><img src='https://onsen.io/images/common/icn_react_top.svg' height='40'><br><strong>React</strong></a></td>
<td align='center' width='150'><a href='https://onsen.io/angular2'><img src='https://onsen.io/images/common/icn_angular2_top.svg' height='40'><br><strong>Angular 2+</strong></a><br></td>
<td align='center' width='150'><a href='https://onsen.io/vue'><img src='https://onsen.io/images/common/icn_vuejs_top.svg' height='40'><br><strong>Vue</strong></a><br></td>
<td align='center' width='150'><a href='https://onsen.io/v2/docs/guide/angular1/index.html'><img src='https://onsen.io/images/common/icn_angular1_top.svg' height='40'><br><strong>AngularJS 1.x</strong></a><br></td>
</tr></tbody>
</table>

Some other frameworks are supported by __community__ packages (not tested or implemented by the core team): [Aurelia](https://www.npmjs.com/package/aurelia-onsenui), [EmberJS](https://www.npmjs.com/package/ember-onsenui).

Both <strong>flat (iOS) and Material (Android) designs</strong> are included. The components are optionally auto-styled based on the platform, which makes it possible to support both iOS and Android with the <strong>same source code</strong>.


## Getting started
We have several resources to help you get started creating hybrid apps and PWAs with Onsen UI:

* __The official docs__: We provide guides and references for all of the components and bindings, as well as how to publish your app. These are our _Getting Started_ guides:
* [Core guide (no framework)](https://onsen.io/v2/guide)
* [Vue guide](https://onsen.io/v2/guide/vue/)
* [React guide](https://onsen.io/v2/guide/react/)
* [Angular 2+ guide](https://onsen.io/v2/guide/angular2/)
* [AngularJS 1.x guide](https://onsen.io/v2/guide/angular1/)
* [jQuery guide](https://onsen.io/v2/guide/jquery/)
* [Creating an Onsen UI hybrid app using Cordova](https://onsen.io/v2/guide/hybrid/cordova.html)
* [Progressive Web Apps (PWAs) with Onsen UI](https://onsen.io/v2/guide/pwa/intro.html)
* __Components overview__: a [list of included CSS components](https://onsen.io/v2/docs/css.html) in both flat and Material Design. Note that these components are just pure and performant CSS without JavaScript behavior. Some extra details (such as dragging or ripple effect) are added by Onsen UI custom elements.
* __Playground__: an [interactive Onsen UI tutorial](https://onsen.io/playground/) where you can learn how to use Onsen UI and play around with the components.
* __Blog__: there are lots of great tutorials and guides published in our [official Onsen UI blog](https://onsen.io/blog/categories/tutorial.html) and we are adding new content regularly.
* __Support__: if you are having trouble using some component the best place to get help is the [Onsen UI Forum](https://community.onsen.io/) or the community-run [Discord Chat](https://discord.gg/JWhBbnE). We are also available to answer short questions on Twitter at [@Onsen_UI](https://twitter.com/Onsen_UI).

## Get Onsen UI

### __Download the latest released version__
We have a [distribution repository](https://github.com/OnsenUI/OnsenUI-dist/releases) with changelog. Onsen UI is also available in __npm__, __bower__ and __jspm__. Example:

```bash
npm install onsenui
```

This downloads the core Onsen UI library. To install bindings, you can install `react-onsenui`, `vue-onsenui`, `ngx-onsenui` or `angularjs-onsenui`.

### __Download or request from a CDN__
You can also take the necessary files from a CDN. Some of the options are [unpkg](https://unpkg.com/onsenui/), [jsDelivr](https://www.jsdelivr.com/package/npm/onsenui) and [cdnjs](https://cdnjs.com/libraries/onsen).

### __Get the latest development build__
Optionally, you can download the [latest development build here](https://onsenui.github.io/latest-build). Be careful, usually everything there is already tested but it might be unstable sometimes.

## Examples with source code
There are lots of sample applications written using Onsen UI. __[Here are some examples](https://onsen.io/samples) with source code and tutorials__ to give you an idea of what kind of apps you can create.

<p align='center'>
<a href='https://argelius.github.io/angular2-onsenui-pokedex/' target='_blank'><img src='https://onsen.io/images/samples/pokedex-pikachu.png'></a>
<a href='http://argelius.github.io/react-onsenui-redux-weather/demo.html' target='_blank'><img src='https://onsen.io/images/samples/react-redux-weather.png'></a>
<a href='https://frandiox.github.io/OnsenUI-YouTube' target='_blank'><img src='https://onsen.io/images/samples/youtube.png'></a>
</p>

## Onsen UI ecosystem
Because sometimes a UI framework may not be enough to make hybrid app development easy, Onsen UI comes with a __complete ecosystem__ of well integrated tools. Meet [__Monaca__](https://monaca.io/).

<p align='center'><a href='https://monaca.io' target='_blank'><img width='300'src='https://onsenui.github.io/art/logos/monaca-logo-2.png'></a></p>

Developed by the Onsen UI team, __Monaca__ is a toolkit that makes hybrid mobile app development with __PhoneGap / Cordova__ simple and easy: Onsen UI Cordova templates, debugging suite, push notifications, remote build, back-end solutions, encryption, version control, continuous integration and more. Furthermore, it provides multiple development environments with everything already configured and ready to go:

<p align='center'>
<a href='https://monaca.io/cloud.html'><strong>Cloud IDE</strong></a> -
<a href='https://monaca.io/cli.html'><strong>Command Line Interface</strong></a> -
<a href='https://monaca.io/localkit.html'><strong>Localkit GUI</strong></a>
</p>

Example with __CLI__:

```
$ [sudo] npm -g install monaca
$ monaca create helloworld # And choose the starter template
$ monaca preview # Preview on the browser
$ monaca debug # Preview on a real device
$ monaca remote build --browser # Production build on the cloud
```

See the [Onsen UI Getting Started Page](http://onsen.io/v2/guide/) for more information.

## Browser Support
Onsen UI is tested to work with the following browsers and mobile OS.

* Android 4.4.4+
* iOS 9+
* Chrome
* Safari

## Contribution
We welcome your contribution, no matter how big or small! Please have a look at the [contribution guide](https://github.com/OnsenUI/OnsenUI/blob/master/CONTRIBUTING.md) for details about project structure, development environment, test suite, code style, etc. All the version updates are mentioned in the [changelog](https://github.com/OnsenUI/OnsenUI/blob/master/CHANGELOG.md).
Binary file added src/materials/Frameworks/OnsenUI/screenshot.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 534678a

Please sign in to comment.