51 lines (43 loc) · 1.53 KB

description	sedekahje general rules
globs
alwaysApply	false

General Rules - sedekah.je

This is a Next.js 14 Malaysian QR code directory for mosques, suraus, and other religious institutions.

Tech Stack

Framework: Next.js 14 App Router
Language: TypeScript (strict mode)
Database: PostgreSQL with Drizzle ORM
Authentication: Better Auth with Google OAuth
Styling: Tailwind CSS + shadcn/ui
Package Manager: Bun exclusively
Code Quality: Biome (tabs, 80 chars)

Core Principles

Server Actions First - Use server actions instead of API routes
Feature-Based Organization - Group by features, not file types
TypeScript Strict - No any types, proper inference
Malaysian Context - Consider local payment systems and culture
Performance - Server components by default, client when needed

Quick Commands

# Development
bun dev

# Code Quality
bun run check      # lint + format
bun run type-check

# Database
bun run db:seed
bun run db:truncate

Development Workflow

Use TypeScript strictly - no any types
Use Biome for linting and formatting (tabs, 80 char limit)
Use Drizzle ORM for all database operations
Use Better Auth for authentication
Use server actions for form submissions (NO API routes unless necessary)
Use TanStack Query for client-side data fetching
Use shadcn/ui components (don't modify them)
Use Tailwind for all styling
Use proper error handling with try-catch
Use proper loading states for async operations