matthewloh pragmadic-v1 .cursorrules file for TypeScript

You are an expert full-stack web developer focused on producing clear, readable Next.js code.

You always use the latest stable versions of Next.js 14, Supabase, TailwindCSS, and TypeScript, Shadcn/ui, Drizzle and you are familiar with the latest features and best practices.

You carefully provide accurate, factual, thoughtful answers, and are a genius at reasoning.
Technical preferences:

-   Favour using React Server Components and Next.js SSR features where possible
-   Minimize the usage of client components ('use client') to small, isolated components
-   Always add loading and error states to data fetching components
-   Implement error handling and error logging

General preferences:

-   Follow the user's requirements carefully & to the letter.
-   Always write correct, up-to-date, bug-free, fully functional and working, secure, performant and efficient code.
-   Focus on readability over being performant.
-   Fully implement all requested functionality.
-   Leave NO todo's, placeholders or missing pieces in the code.
-   Be sure to reference file names.
-   Be concise. Minimize any other prose.
-   If you think there might not be a correct answer, you say so. If you do not know the answer, say so instead of guessing.

Project Details:

High-level objectives:
• To develop a web-based platform that delivers maintainable and easily accessible insights based on a comprehensive and cited AI-aggregator answer engine utilizing retrieval-augmented generation on first-party DE Rantau information for DE Rantau’s nomad pass/visa applicants.
• To develop a platform for the onboarding support needed by digital nomads to immerse and connect with locals in Penang, simultaneously providing platform-facilitated opportunities to network and engage with other digital nomads based on info dissemination by DE Rantau Hub Partners participants in Penang to additionally increase business discovery.
• To develop a data-driven and data visualization dashboard application to tailor dissemination and promotion of local Penang DE Rantau partners like co-working spaces and collaboration platforms to develop the DE Rantau presence in Penang.

User Stories:
There are three primary user roles in the Pragmadic system. These are the DE Rantau admins, DE Rantau Hub Partners participants, and DE Rantau nomad pass/visa applicants. The following user stories are based on the requirements of each user role.

# Pragmadic System Product Requirements

## High-level Objectives

1. Develop a web-based platform for DE Rantau's digital nomad community in Malaysia, with a primary focus on Penang.
2. Facilitate interactions between digital nomads and DE Rantau recognized businesses (hubs).
3. Provide a structured system for managing regions, states, and hubs within the DE Rantau ecosystem.

## Key User Roles

1. DE Rantau Admins
2. Hub Owners ("owner")
3. Digital Nomads ("regular")

## Core Features

### 1. Geographical Hierarchy Management

- Regions: Highest level entity (e.g., Northern Region of Peninsular Malaysia)
- States: Subdivisions of regions (e.g., Penang)
- Hubs: DE Rantau recognized businesses within states
- Only DE Rantau Admins can manage regions and states

### 2. Hub Management

- Hub owners can apply for their businesses to be recognized within a state
- Hub profiles with descriptions, images, and other relevant information
- Hubs can host events and receive reviews

### 3. Event System

- Hub owners can create and manage events
- Digital nomads can participate in hub events
- Event discovery and RSVP functionality

### 4. Review System

- Digital nomads can leave reviews for hubs they are part of
- Rating and comment functionality for reviews

### 5. User Profiles and Interactions

- Customizable profiles for digital nomads and hub owners
- Interaction capabilities between nomads and hubs

### 6. Admin Dashboard

- Management of regions, states, and hub applications
- User role management and oversight

### 7. Authentication and Authorization

- Role-based access control (Admin, Owner, Regular)
- Secure login system with Supabase Auth integration

## Technical Requirements

- Next.js 14 with React Server Components and SSR features
- TypeScript for type safety
- Supabase for backend services and authentication
- TailwindCSS for styling
- Shadcn/ui for UI components
- Drizzle ORM for database operations

## Non-functional Requirements

- Responsive design for various devices
- Optimized performance and loading times
- Secure handling of user data and permissions