Hatim App hatim.app

Three apps, one rule book.

The website, the iOS/Android app and the server share the same core. A business rule is written once; neither the UI nor the server rewrites it. Dependencies only point inward, and ESLint guards the boundaries.

class MemberAction<A> {
  constructor(
    private readonly ruleFn: MemberRule<A>,
    protected readonly groups: GroupRepository,
    private readonly khatms: KhatmRepository,
    private readonly session: SessionReader,
    private readonly clock: Clock,
  ) {}
  async execute(groupId: string, khatmId: string, arg: A): Promise<Khatm> {
    const user = await signedInUser(this.session);
    // Yönetici de üyelik tablosundadır
    if ((await this.groups.membership(groupId, user.id)) !== "member") throw authRequired("joinGroupFirst");
    const k = await fetchKhatm(this.khatms, groupId, khatmId);
    const updated = this.ruleFn(k, arg, { id: user.id, name: user.name }, this.clock.now());
    if (updated !== k) {
      await this.khatms.save(updated);
      await this.changed(updated, arg, user);
    }
    return updated;
  }
  protected async changed(_k: Khatm, _arg: A, _user: User): Promise<void> {}
}

Rules

• 01

  A rule is written once

  Business rules are never rewritten in the UI or an API handler; they go into @hatim/core and all three sides use them from there.

• 02

  Dependencies point inward

  domain → application → infrastructure → di → presentation. The UI can't reach a repository directly.

• 03

  Double-tap safe

  Database constraints, row locks and an Idempotency-Key. If the same request arrives twice, nothing changes.

• 04

  The core produces no text

  Errors come back as codes and the UI translates them from a dictionary. One Turkish and English dictionary, shared by web and mobile.

• 05

  Same name, same job

  Atomic Design: Button, Sheet and KhatmScreen do the same job under the same name on web and mobile.

• 06

  Works offline

  The Quran text and translations are bundled; on the web a service worker keeps the pages you've visited.

Tech stack

• TypeScript
• Bun
• Next.js 16
• React 19
• Expo SDK 58
• React Native
• Reanimated
• Hono
• PostgreSQL
• Drizzle
• Better Auth
• Firebase (FCM)
• Web Push
• Vitest
• EAS