# react-native-unsplash-screen

> Splash screen using Unsplash API

Latest version **1.0.3** (published 2018-09-24) · MIT license · 0 weekly downloads

## Install

```sh
npm install react-native-unsplash-screen
pnpm add react-native-unsplash-screen
yarn add react-native-unsplash-screen
bun add react-native-unsplash-screen
```

## Health

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

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.3 |
| Published | 2018-09-24 |
| First published | 2018-09-24 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 1 |
| Unpacked size | 940.4 KB |
| Known vulnerabilities | 0 (+24 in 1 direct dependencies) |
| Install scripts | no |
| Author | vishal9950 |
| Maintainers | vishal9950 |
| Keywords | react-native, splash screen, unsplash, loading, screen, react, native, android, ios |

## Links

- npm: https://www.npmjs.com/package/react-native-unsplash-screen
- Repository: https://github.com/vishal9950/react-native-unsplash-screen
- Issues: https://github.com/vishal9950/react-native-unsplash-screen/issues
- npm.io page: https://npm.io/package/react-native-unsplash-screen

## Dependencies (1)

- [axios](https://npm.io/package/axios.md) ^0.18.0

## Alternatives

- [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads
- [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads
- [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads
- [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads
- [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads

## Recent versions

- 1.0.3 (latest) — 2018-09-24
- 1.0.2 — 2018-09-24
- 1.0.1 — 2018-09-24
- 0.0.1 — 2018-09-24

## README

# react-native-unsplash-screen
[![https://nodei.co/npm/react-native-unsplash-screen.png?downloads=true&downloadRank=true&stars=true](https://nodei.co/npm/react-native-unsplash-screen.png?downloads=true&downloadRank=true&stars=true)](https://www.npmjs.com/package/react-native-unsplash-screen)

A react-native package that provides you the most awe-inspiring splash-screen/loading screen made from pictures provided by Unsplash API. The pictures you get are randomized and you get a new picture everytime 😌.

Use it for bootstrapping your new application and get it done right the first time 😎 or just let it be as is in your application throughout 😊.

It also praises the artists on Unsplash by providing a link back to their work on Unsplash ✌🏻.

## Installation
`yarn add react-native-unsplash-screen`
or
`npm i react-native-unsplash-screen`

After you have the package installed, you need to add some native code for android and ios. To let react-native handle that, just run

`react-native link`

This will do the necessary changes in your native android/ios code.

## Usage
### Unsplash key
Go to [Unsplash Developers](https://unsplash.com/developers) and register your app to get a demo access key which gives you 50 requests per hour, which should be enough for smaller projects, but you can always opt for the production or enterprise keys.
### Go for it
Once you have the key, import the screen as any other component in your code and provide the Unsplash API `access_key` and your app's name.

```js
import React, {Component} from 'react';
import UnSplashScreen from 'react-native-unsplash-screen';

export default class App extends Component {
  render() {
    return (
      <UnSplashScreen
        clientId="YOUR_ACCESS_KEY"
        logoText="YOUR_APP_NAME" // defaults to 'MyApp'
      />
    );
  }
}

```

...and voila

<img src="https://github.com/vishal9950/react-native-unsplash-screen/raw/master/sample/voila.gif" height= "437" width="213" />

Note that it is just a component, so you can go all crazy about how you are gonna use it. I personally used it as a splash screen as well as a loading screen 👌🏻.

Depending on your use case you can make changes to the component by forking the repo and applying your changes over it.

For any issues, head on to the issue section [here](https://github.com/vishal9950/react-native-unsplash-screen/issues).

Happy Coding! 😊

---
_Source: https://npm.io/package/react-native-unsplash-screen · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._