Git Product home page Git Product logo

website's Introduction

React Native Directory

React Native Directory is a website where you can see all of the libraries that are compatible with React Native.

Note: A transition in progress from https://native.directory to https://reactnative.directory, so the following links may not work for you yet!

Website: https://reactnative.directory/

How do I know I'm at the right place?

  • You made a repository on GitHub and you want the world to know it works with React Native.
  • You want to submit a pull request to improve React Native Directory.
  • You want to report a bug or make a suggestion.

I don't like your website, can I hit an API instead and build my own better stuff?

Sure, go for it!

https://reactnative.directory/api/libraries

  • Returns a list of all libraries in JSON format.

https://reactnative.directory/api/libraries?search=webgl

  • Returns a list of all libraries in JSON format that have the keyword webgl.

https://reactnative.directory/api/libraries?search=webgl&expo=true

  • Returns a list of all libraries in JSON format that have the keyword webgl and work with Expo managed.

https://reactnative.directory/api/libraries?search=webgl&expo=true&android=true

  • Returns a list of all libraries in JSON format that have the keyword webgl and work with Expo managed and Android.

https://reactnative.directory/api/libraries?search=webgl&expo=true&android=true&isPopular=true

  • Returns a list of all libraries in JSON format that have the keyword webgl, work with Expo managed and Android and are popular based on the scoring criterion.

I don't like how you calculate health scores.

  • Submit a PR with changes to scripts/calculate-score.js.
  • You have all the power! Tell us what you want.

How do I add a library?

  • Add it to react-native-libraries.json.
  • Submit a PR.

Please follow this format and indentation:

{
  "githubUrl": "<THE GITHUB URL>",
  "npmPkg": "<NPM PACKAGE NAME>",
  "examples": ["<THE URL TO REPO>", "<THE URL TO A SNACK>"],
  "images": ["<PUBLIC URL TO RELATED IMAGE>"],
  "ios": false,
  "android": false,
  "web": false,
  "expo": false,
  "windows": false,
  "macos": false,
  "unmaintained": false
},
  • githubUrl - where we can find the repository on GitHub (currently other git hosts are not supported).
  • npmPkg - optional string of the package's display name.
  • examples - optional array of URLs (snacks preferred) with demonstrations of the library.
  • images - optional array of images that will show up in the listing to preview the library functionality.
  • ios - works on iOS phones.
  • android - works on Android phones.
  • web - can be used in the browser.
  • expo - can be used in managed workflow, without ejecting an Expo application (any library can be used if you eject).
  • windows - can be used with react-native-windows.
  • macos - can be used with react-native-macos.
  • unmaintained - optional boolean to signify that a library is or is not maintained.

Note: If your package is within a monorepo on GitHub, eg: https://github.com/expo/expo/tree/master/packages/expo-web-browser, then the name, description, homepage, and topics (keywords) will be extracted from package.json for that subrepo. GitHub stats will be based on the monorepo, because there isn't really another option.

How do I run my own version locally?

Prerequisites

  • Node LTS

Commands

With npm
npm install
npm start
With yarn
yarn
yarn start

You should be able to visit localhost:3000 in your browser.

How do I run npm run data:update with keys?

This command creates site data in ./assets/data.json

GITHUB_TOKEN=<*> npm run data:update

How do I deploy my own version of this?

  • Site is hosted on Now, and this is the easiest way to do it.
  • You can deploy your own with your own Now account
  • You will need to provide GITHUB_TOKEN environment variable in your Vercel configuration.
# once environment variables are configured, install now and deploy
npm i -g now
now

How do I deploy to production?

Get a commit on master and it will be automatically deployed.

website's People

Contributors

jimmylee avatar brentvatne avatar turnrye avatar simek avatar jonsamp avatar gorhom avatar alexbrazier avatar mitulsavani avatar xcarpentier avatar lwinkyawmyat avatar prscx avatar kpose avatar luism3861 avatar wonday avatar noitidart avatar serranoarevalo avatar lfkwtz avatar matt-oakes avatar naturalclar avatar gertjanreynaert avatar deadcoder0904 avatar khalisafkari avatar kristerkari avatar dependabot[bot] avatar charlesvinette avatar calebdeji avatar wbroek avatar vmurin avatar phamfoo avatar bell-steven avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.