https://github.com/kristerkari/react-native-css-modules-with-viewport-units-example
An example app to show how CSS Viewport Units work in React Native.
https://github.com/kristerkari/react-native-css-modules-with-viewport-units-example
css css-modules demo-app example example-app react-native viewport-units
Last synced: 2 months ago
JSON representation
An example app to show how CSS Viewport Units work in React Native.
- Host: GitHub
- URL: https://github.com/kristerkari/react-native-css-modules-with-viewport-units-example
- Owner: kristerkari
- Created: 2018-06-05T22:18:05.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2019-03-05T21:58:01.000Z (over 7 years ago)
- Last Synced: 2025-02-09T07:30:03.067Z (over 1 year ago)
- Topics: css, css-modules, demo-app, example, example-app, react-native, viewport-units
- Language: Objective-C
- Size: 3.43 MB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# React Native CSS modules with CSS Viewport Units
[](https://egghead.io/courses/how-to-contribute-to-an-open-source-project-on-github)
This is an example app that shows how you can use [CSS Viewport Units](https://alligator.io/css/viewport-units/) in React Native.
This app should work the same way as [vw/vh Middle Div](https://codepen.io/falkus/pen/LkmLJR) codepen by [Martin Falkus](https://codepen.io/falkus/). You can try to run in first in the browser and then see how it works in React Native.
To see code examples, have a look at [ViewportUnits.css](src/ViewportUnits.css) and [ViewportUnits.js](src/ViewportUnits.js) inside src folder.
**Quick links:** **[Features](#example-app-features)** • **[Try it](#try-it)** • **[Documentation](https://github.com/kristerkari/react-native-css-modules#documentation)**
## Example App features
#### React Native and Web
- :computer: Uses [CSS Viewport Units](https://alligator.io/css/viewport-units/) and the responsive scaling works the same way in React Native and web browsers.
- :tada: Allows `className` and `style` properties to be used on React Native elements such as `` or ``.
- :fire: CSS Hot loading (live reloading).
- :mag: [Custom stylelint config for React Native CSS modules](https://github.com/kristerkari/stylelint-config-react-native-css-modules)
#### React Native specific
- :package: Uses [React Native CSS modules](https://github.com/kristerkari/react-native-css-modules)
- :globe_with_meridians: [Platform specific file extensions](https://facebook.github.io/react-native/docs/platform-specific-code.html#platform-specific-extensions), e.g. `styles.ios.css`, `styles.android.css`, `styles.native.css`.
#### Web specific
- :package: Uses [Webpack](https://webpack.js.org/) + [CSS modules](https://github.com/css-modules/css-modules).
- :wrench: Uses [React Native for Web](https://github.com/necolas/react-native-web) to make most React Native elements work in the browser.
## Supported Browsers
- Mobile: Android Stock browser (4.4-5.x), Android Chrome, iOS Safari 8+
- Desktop: Firefox, Chrome, Safari
## Try it
### Step 1: Install depencies to run React Native
Make sure that you have `react-native-cli` installed (`npm install -g react-native-cli`) and [XCode](https://developer.apple.com/xcode/) (for iOS development) / [Android Studio](https://developer.android.com/studio/index.html) (for Android development) installed and working.
- Go to "Building Projects with Native Code" tab and follow the guide: https://facebook.github.io/react-native/docs/getting-started.html
### Step 2: Clone the repo and move to project
```sh
git clone git@github.com:kristerkari/react-native-css-modules-with-viewport-units-example.git
cd react-native-css-modules-with-viewport-units-example
```
### Step 3: Install example app's dependencies
```sh
npm install
```
### Step 4: Run React Native packager
You can open a new terminal tab to run React Native's packager.
```sh
npm start
```
### Step 5: Run app on Android, iOS or Web
First make sure that your Android emulator or iOS simulator is working, then:
```sh
npm run ios
```
or
```sh
npm run android
```
or
```sh
npm run web
```
Web app can be accessed by opening `http://localhost:8080` in a browser.
---
...or if you use Yarn:
```sh
yarn ios
```
```sh
yarn android
```
```sh
yarn web
```