# @blueeast/bluerain-os

> A browser based OS, made with React JS

Latest version **4.1.1** (published 2018-12-27) · MIT license · 0 weekly downloads

## Install

```sh
npm install @blueeast/bluerain-os
pnpm add @blueeast/bluerain-os
yarn add @blueeast/bluerain-os
bun add @blueeast/bluerain-os
```

## Health

**Score 25/100 (F)** — status: abandoned.

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 4.1.1 |
| Published | 2018-12-27 |
| First published | 2017-08-18 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >=6.0.0 |
| Dependencies | 16 |
| Unpacked size | 269.9 KB |
| Known vulnerabilities | 0 (+1 in 1 direct dependencies) |
| Install scripts | no |
| Author | BlueEast Team |
| Maintainers | artalat, bjavaid |

## Links

- npm: https://www.npmjs.com/package/@blueeast/bluerain-os
- Repository: https://github.com/BlueEastCode/bluerain-os
- Homepage: https://github.com/BlueEastCode/bluerain-os#readme
- Issues: https://github.com/BlueEastCode/bluerain-os/issues
- npm.io page: https://npm.io/package/@blueeast/bluerain-os

## Dependencies (16)

- [deepmerge](https://npm.io/package/deepmerge.md) ^2.0.1
- [immutable](https://npm.io/package/immutable.md) ^3.8.2
- [recompose](https://npm.io/package/recompose.md) ^0.27.1
- [lodash.get](https://npm.io/package/lodash.get.md) ^4.4.2
- [lodash.set](https://npm.io/package/lodash.set.md) ^4.3.2
- [prop-types](https://npm.io/package/prop-types.md) ^15.6.0
- [lodash.isnil](https://npm.io/package/lodash.isnil.md) ^4.0.0
- [eventemitter3](https://npm.io/package/eventemitter3.md) ^2.0.3
- [babel-polyfill](https://npm.io/package/babel-polyfill.md) ^6.26.0
- [lodash.flowright](https://npm.io/package/lodash.flowright.md) ^3.5.0
- [lodash.isboolean](https://npm.io/package/lodash.isboolean.md) ^3.0.3
- [lodash.kebabcase](https://npm.io/package/lodash.kebabcase.md) ^4.1.1
- [react-dom-factories](https://npm.io/package/react-dom-factories.md) ^1.0.2
- [create-react-context](https://npm.io/package/create-react-context.md) ^0.2.1
- [@blueeast/proxy-polyfill](https://npm.io/package/@blueeast/proxy-polyfill.md) ^0.1.9
- [@blueeast/bluerain-ui-interfaces](https://npm.io/package/@blueeast/bluerain-ui-interfaces.md) ^4.0.0-beta.9

## Recent versions

- 4.1.1 (latest) — 2018-12-27
- 4.1.0 — 2018-12-21
- 4.0.1 — 2018-12-19
- 4.0.0 — 2018-12-17
- 3.16.0 — 2018-11-29
- 3.15.2 — 2018-11-29
- 3.15.1 — 2018-09-27
- 3.15.0 — 2018-09-19
- 3.14.2 — 2018-09-06
- 3.14.1 — 2018-08-30
- 3.14.0 — 2018-08-21
- 3.13.9 — 2018-08-21
- 3.13.8 — 2018-08-07
- 3.13.7 — 2018-08-03
- 3.13.6 — 2018-07-11
- … 72 more at https://npm.io/package/@blueeast/bluerain-os/versions

## README

> ⚠️ This is a work in progress and the API is not stable. May not be fit for use in production. 

# BlueRain OS

[![Greenkeeper badge](https://badges.greenkeeper.io/BlueEastCode/bluerain-os.svg)](https://greenkeeper.io/) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/BlueEastCode/bluerain-os/blob/master/CONTRIBUTING.md)

A modular, pluggable and cross-platform app framework. It is built on top of [ReactXP](https://microsoft.github.io/reactxp/) (which utilizes [ReactDOM](https://facebook.github.io/react/docs/react-dom.html) for web and [React Native](https://facebook.github.io/react-native/) for mobile).

## 🎊 Status

[![npm version](https://badge.fury.io/js/%40blueeast%2Fbluerain-os.svg)](https://github.com/BlueEastCode/bluerain-os) [![Build Status](https://travis-ci.org/BlueEastCode/bluerain-os.svg?branch=master)](https://travis-ci.org/BlueEastCode/bluerain-os) [![bitHound Overall Score](https://www.bithound.io/github/BlueEastCode/bluerain-os/badges/score.svg)](https://www.bithound.io/github/BlueEastCode/bluerain-os) [![bitHound Dependencies](https://www.bithound.io/github/BlueEastCode/bluerain-os/badges/dependencies.svg)](https://www.bithound.io/github/BlueEastCode/bluerain-os/develop/dependencies/npm) [![bitHound Dev Dependencies](https://www.bithound.io/github/BlueEastCode/bluerain-os/badges/devDependencies.svg)](https://www.bithound.io/github/BlueEastCode/bluerain-os/develop/dependencies/npm) [![bitHound Code](https://www.bithound.io/github/BlueEastCode/bluerain-os/badges/code.svg)](https://www.bithound.io/github/BlueEastCode/bluerain-os) [![Known Vulnerabilities](https://snyk.io/test/npm/@blueeast/bluerain-os/badge.svg)](https://snyk.io/test/npm/@blueeast/bluerain-os)

## 📰 Whats New in v4
BlueRainOS now exports a getComponent method.

`import { getComponent } from '@blueeast/bluerain-os;` 

you can get any component you have registered.

`const View = getComponent<ViewProperties>('View');`

and export it to use it anywhere in your app with BlueRainConsumer. or you can stick with the previous approach i.e.

`const View = BR.Components.get('View')`

or you can use ity directly

`<BR.Components.View> anything </BR.Components.View>`

under BlueRainConsumer.

Some components are already exported from module. you can use them simply by importing from @blueeast/bluerain-os like so

`import { View, Text, List } from '@blueeast/bluerain-os'`

## 🎭 Platforms
- 📱 Mobile (Android & iOS) with [React Native](https://facebook.github.io/react-native/) through [ReactXP](https://microsoft.github.io/reactxp/)
- 💻 Web with [ReactDOM](https://facebook.github.io/react/docs/react-dom.html)
- 🖥 Desktop with [ReactDOM](https://facebook.github.io/react/docs/react-dom.html) & [Electron](https://electron.atom.io/)

## 🏆 Features
- 📦 Apps Architecture
- 🤖 Plugin Architecture
- 🔧 Centralized Configurations
- 💅 Themes
- 🔥 Event and Callbacks
- 🌏 Server Side Rendering
- 🔀 Routing through React Router 4

### 🎨 Other features through official plugins
- 🈯️ Internationalization through react-intl
- 💥 State management through redux
- 🚀 GraphQL integration through Apollo GraphQL Client
- 🚨 Error Reporting through Sentry integration


## 🤖 Available plugins

Name | Description | Dependency
------ | ------ | ------
Apollo | A fully-featured, production ready caching GraphQL client for every server or UI framework. Based on [Apollo Client](http://dev.apollodata.com/react/). | Redux
Internationalization | Internationalize React apps. This library provides React components and an API to format dates, numbers, and strings, including pluralization and handling translations. Based on [react-intl](https://github.com/yahoo/react-intl). | Redux
Material UI | Adds [Material UI](http://www.material-ui.com/#/) theme Provider to BlueRain. | 
React Router (v4) | [React Router V4](https://github.com/ReactTraining/react-router) and [Redux integration](https://github.com/ReactTraining/react-router/tree/master/packages/react-router-redux). | Redux
Redux | Predictable state container for JavaScript apps. Based on [Redux](http://redux.js.org/) & [React Redux](https://github.com/reactjs/react-redux).
Redux DevTools | [DevTools](https://github.com/gaearon/redux-devtools) for Redux with hot reloading, action replay, and customizable UI.  | Redux
Sentry (Coming Soon) | [Sentry](https://sentry.io/) is a cross-platform crash reporting and aggregation platform. 

## Badge

Let people know that your app is build using **bluerain-os** by including this badge in your readme.

[![bluerain-os](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/blueeastcode/bluerain-os)

```md
[![bluerain-os](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/blueeastcode/bluerain-os)
```

---
_Source: https://npm.io/package/@blueeast/bluerain-os · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
