Introduction

Fireclass turns Firestore documents into type-safe TypeScript classes. Define a model once and get typed CRUD, typed queries, validation, and — on the client — realtime hooks. One modeling core powers every runtime, so the API is identical whether you're on the server with firebase-admin or in the browser with the Firebase client SDK.

import { Collection } from "@dharayush7/fireclass-js";
import { IsEmail, IsInt, Min } from "class-validator";
import { BaseModel } from "../lib/fireclass";
 
@Collection("users")
export class User extends BaseModel<User> {
  @IsEmail() email!: string;
  @IsInt() @Min(0) age!: number;
 
  constructor(data?: Partial<User>) {
    super(data);
    Object.assign(this, data);
  }
}
 
const id = await new User({ email: "ada@example.com", age: 36 }).save();
const adults = await User.findMany({ where: { age: { gte: 18 } } });

The suite

Why Fireclass

• Type-safe by default. Models are classes; queries, results, and filters are all typed — no codegen step.
• Validation built in. class-validator decorators run on every save(), surfacing a typed ValidationFailedError.
• Realtime on the client. useQuery and useDoc subscribe via onSnapshot and re-render on every change.
• Next.js ready. server-only models, a memoized admin singleton, and an RSC serialization bridge.
• One command to start. npx fireclass init detects your framework and wires everything up.

Next steps

• Installation — add Fireclass to your project.
• Quick Start — define a model, save it, and query it.
• CLI — scaffold and manage your setup.