react-doorman

Core library used by react-native-doorman for Firebase phone auth. This doesn't have UI components โ€“ it's meant to let non-React Native apps use Doorman's convenience hooks & components without the dependencies.

Usage no npm install needed!

<script type="module">
  import reactDoorman from 'https://cdn.skypack.dev/react-doorman';
</script>

README

Doorman ๐Ÿšช๐Ÿ”ฅ

Compatibility

v1 requires Firebase 8.

v2 (alpha) comes with headless mode, to allow users to customize usage for react-native-firebase.

To use with Firebase v9, you need v3.

Firebase v9 example usage with Doorman v3:

// App.js
import { makeHeadless } from 'react-doorman'
import { withPhoneAuth } from 'react-native-doorman'
import { getAuth, onIdTokenChanged, initializeApp } from 'firebase/auth'

const firebaseConfig = {
  //...
}
const firebaseApp = initializeApp(firebaseConfig)

// Call this at the root of your app before using doorman
makeHeadless({
  signOut: () => {
    return getAuth(firebaseApp).signOut()
  },
  onIdTokenChanged: (callback) => {
    return getAuth(firebaseApp).onIdTokenChanged(callback)
  },
  signInWithCustomToken: (token) => {
    return getAuth(firebaseApp).signInWithCustomToken(token)
  },
})

export default withPhoneAuth(App)

๐Ÿง What is Doorman?

Doorman lets React Native developers add phone authentication to their apps with ease. It works perfectly with Firebase Auth and Expo.

We handle the backend and provide UI components ๐Ÿ˜‡ for Firebase phone auth. That means you can spend less time worrying about the auth flow, and more time building your actual features.

Our mission is to help you create incredible apps that your users will love. And that all starts with the first impression they make with your app โ€“ your auth flow.

๐Ÿ˜Ž With Doorman, you can...

  • ๐Ÿ‘ŸBuild a phone authentication flow in a few lines of code.

  • ๐Ÿ’…Fully customize the design to fit your app.

  • ๐Ÿ‘ฉโ€๐Ÿ’ปAvoid maintaining a complex server.

  • ๐Ÿ”ฅKeep using Firebase Auth with Expo.

  • ๐Ÿ•บCreate a native auth experience, without web views or popups.

๐Ÿ‘พ Docs

We have great documentation. Check out our setup guide.

๐Ÿค– Examples

๐Ÿ‘ฉโ€๐Ÿ’ป Website

Check out doorman.cool.

๐Ÿšจ For issues

Please use this repository to notify us of any issues and track ones we're working on.

You can also live chat us on our website with any tight concerns. That said, we prefer that you make an issue here so that everyone else can fix problems you might have.