Skip to content

FormFree/react-native-ff-elements

Repository files navigation

FormFree React Native Elements

[![MIT License][license-badge]][license]

A React Native library for apps.

Package Versions

Name Latest Version
@react-native-ff-elements/common badge
@react-native-ff-elements/core badge
@react-native-ff-elements/ui badge

Contributing

Please read through our contribution guide to get started!

Installing from a fork on GitHub

Since we use a monorepo, it's not possible to install a package from the repository URL. If you need to install a forked version from Git, you can use gitpkg.

First install gitpkg:

npm install --global gitpkg

Then follow these steps to publish and install a forked package:

  1. Fork this repo to your account and clone the forked repo to your local machine
  2. Open a Terminal and cd to the location of the cloned repo
  3. Run npm i to install any dependencies
  4. If you want to make any changes, make them and commit
  5. Run npm run build to perform the build steps
  6. Now cd to the package directory that you want to use (e.g. cd packages/core for @react-native-ff-elements/core)
  7. Run gitpkg publish to publish the package to your repo

After publishing, you should see something like this:

Package uploaded to [email protected]:<user>/<repo>.git with the name <name>

You can now install the dependency in your project:

npm i <user>/<repo>.git#<name>

Remember to replace <user>, <repo> and <name> with right values.

Installing from a fork on GitHub

Since we use a monorepo, it's not possible to install a package from the repository URL. If you need to install a forked version from Git, you can use gitpkg.

First install gitpkg:

npm install --global gitpkg

Then follow these steps to publish and install a forked package:

  1. Fork this repo to your account and clone the forked repo to your local machine
  2. Open a Terminal and cd to the location of the cloned repo
  3. Run npm i to install any dependencies
  4. If you want to make any changes, make them and commit
  5. Run npm run build to perform the build steps
  6. Now cd to the package directory that you want to use (e.g. cd packages/core for @react-native-ff-elements/core)
  7. Run gitpkg publish to publish the package to your repo

After publishing, you should see something like this:

Package uploaded to [email protected]:<user>/<repo>.git with the name <name>

You can now install the dependency in your project:

npm i <user>/<repo>.git#<name>

Remember to replace <user>, <repo> and <name> with right values.