Firebase Patterns

Real-time listener:

import { onSnapshot } from 'firebase/firestore'

// In Zustand store:
const unsubscribe = onSnapshot(
  query(collection(fireDB, 'products'), orderBy('time', 'desc')),
  (snapshot) => {
    const items = snapshot.docs.map(doc => ({ id: doc.id, ...doc.data() } as ProductT))
    set({ products: items })
  }
)
// IMPORTANT: Return unsubscribe for cleanup

Create document:

import { addDoc, collection, serverTimestamp } from 'firebase/firestore'

await addDoc(collection(fireDB, 'orders'), {
  ...orderData,
  time: serverTimestamp(),
  date: serverTimestamp(),
})

Update document:

import { doc, updateDoc } from 'firebase/firestore'

await updateDoc(doc(fireDB, 'products', productId), {
  title: newTitle,
  price: newPrice,
})

Delete document:

import { doc, deleteDoc } from 'firebase/firestore'
await deleteDoc(doc(fireDB, 'products', productId))

Authentication

Sign up:

import { createUserWithEmailAndPassword } from 'firebase/auth'
const credential = await createUserWithEmailAndPassword(auth, email, password)
// Then create user doc in Firestore "user" collection
await addDoc(collection(fireDB, 'user'), {
  name, email, uid: credential.user.uid, role: 'user', phone, time: serverTimestamp(), date: serverTimestamp()
})

Sign in:

import { signInWithEmailAndPassword } from 'firebase/auth'
await signInWithEmailAndPassword(auth, email, password)

Auth state listener (in AuthProvider):

import { onAuthStateChanged } from 'firebase/auth'
onAuthStateChanged(auth, (user) => {
  if (user) { /* fetch user data from Firestore */ }
  else { /* clear auth state */ }
})

Storage

Upload image:

import { ref, uploadBytes, getDownloadURL } from 'firebase/storage'
const storageRef = ref(fireStorage, `products/${storageFileId}/${file.name}`)
await uploadBytes(storageRef, file)
const url = await getDownloadURL(storageRef)

Delete image:

import { ref, deleteObject } from 'firebase/storage'
await deleteObject(ref(fireStorage, imagePath))

Collections Schema

API Routes (Admin SDK)

• app/api/delete-user/route.ts - Uses firebase-admin to delete Auth user
• app/api/sendOrderEmail/route.ts - Sends email via Nodemailer

Important Notes

• Product price is stored as string, not number - be careful with calculations
• storageFileId is generated with uuid for grouping multiple images
• Draft store (useDraftStore.ts) cleans up Storage images when drafts expire
• Orders store user's uid for filtering in order history