universal-firebase-auth/README.md

A reusable Firebase-based authentication package like Clerk for React with social login support (Google, Facebook, GitHub, LinkedIn, etc).

# universal-firebase-auth

**One install = full Firebase social auth (Google, Facebook, GitHub, LinkedIn, Twitter, Email).**

```bash
npm i universal-firebase-auth
```

```jsx
// _app.jsx or main.jsx
import { AuthProvider } from "universal-firebase-auth";

<AuthProvider config={firebaseConfig}>
  <App />
</AuthProvider>
```

```jsx
import { LoginButton, useAuth } from "universal-firebase-auth";

<LoginButton provider="google" />
<LoginButton provider="facebook" />
<LoginButton provider="github" />
<LoginButton provider="linkedin" />
<LoginButton provider="twitter" />

const { user, logout } = useAuth();
```

**Why?** No separate `firebase` install needed – SDK bundled internally. Just bring your Firebase project config.
*/