Getting Started

Installation

Configure registry access and install @frappes/firebase.

Install @frappes/firebase in two steps:

  1. configure the @frappes scope registry
  2. install the package

1) Configure your registry first

Add this in your project .npmrc:

.npmrc
@frappes:registry=https://npm.pkg.github.com

If your registry requires authentication, also add:

.npmrc
//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}
Do not commit plaintext tokens. Use environment variables (for example GITHUB_TOKEN) in CI/local shells.

2) Install the package

pnpm add @frappes/firebase firebase

firebase is required when using createFirebaseFirestorePort.

Verify installation

check.ts
import { createFirestoreCoreClient } from "@frappes/firebase"

console.log(typeof createFirestoreCoreClient)

If this compiles, your install is ready.

Copyright © 2026