📝 Add docstrings to issue-bundle-fixes

Docstrings generation was requested by @Arun-kushwaha007.

The following files were modified:

* `apps/mobile/app/components/ui/MoneyText.tsx`
* `apps/mobile/app/screens/ActivityScreen.tsx`
* `apps/mobile/app/screens/AddExpenseScreen.tsx`
* `apps/mobile/app/screens/ExpenseDetailScreen.tsx`
* `apps/mobile/app/screens/GroupDetailScreen.tsx`
* `apps/mobile/app/screens/GuestGroupDetailScreen.tsx`
* `apps/mobile/app/screens/HomeScreen.tsx`
* `apps/web/app/dashboard/activity/page.tsx`
* `apps/web/app/dashboard/groups/[groupId]/page.tsx`
* `apps/web/app/dashboard/page.tsx`
* `apps/web/app/share/[token]/page.tsx`
* `apps/web/src/components/activity/ActivityFeed.tsx`
* `apps/web/src/components/dashboard/ActivityList.tsx`
* `apps/web/src/components/groups/ExpenseDetailCard.tsx`
* `apps/web/src/components/groups/ExpenseRow.tsx`
* `apps/web/src/components/groups/ExpenseTable.tsx`
* `apps/web/src/components/groups/GroupSummaryPanel.tsx`
* `apps/web/src/components/groups/RecurringExpenseList.tsx`
* `apps/web/src/components/groups/SettlementList.tsx`
* `packages/shared-types/src/index.ts`

These files were ignored:
* `apps/backend/src/activity/activity.service.spec.ts`

These file types are not supported:
* `README.md`

Author: coderabbitai[bot]

apps/mobile/app/components/ui/MoneyText.tsx

@@ -10,6 +10,15 @@ interface MoneyTextProps {
   currency?: CurrencyCode;
 }
 
+/**
+ * Render a Text element showing a formatted currency amount.
+ *
+ * @param cents - Amount in cents as a string (e.g., `"150"` for $1.50)
+ * @param size - One of `'sm' | 'md' | 'lg'`; controls the text font size
+ * @param variant - One of `'default' | 'success' | 'danger'`; controls the text color
+ * @param currency - Currency code used for formatting (defaults to `'USD'`)
+ * @returns A React Native Text element displaying the formatted currency string; the same string is used for the accessibility label
+ */
 export function MoneyText({ cents, size = 'md', variant = 'default', currency = 'USD' }: MoneyTextProps) {
   const { colors } = useAppTheme();
   const amount = formatCurrencyFromCents(cents, currency);

apps/mobile/app/screens/ActivityScreen.tsx

@@ -82,6 +82,15 @@ const relativeTime = (iso: string): string => {
   return `${diffDay}d ago`;
 };
 
+/**
+ * Render the Activity screen showing a scrollable, paginated list of activity events for a specific group or the current user.
+ *
+ * The screen loads the first page on mount, supports pull-to-refresh and infinite scroll pagination, animates item entry,
+ * and displays loading or empty states as appropriate. Amounts and currencies are resolved from activity metadata when available.
+ *
+ * @param route - Optional navigation route; if `route.params.groupId` is provided the screen shows that group's activity, otherwise it shows the current user's activity.
+ * @returns The rendered Activity screen element.
+ */
 export function ActivityScreen({ route }: { route?: { params?: { groupId?: string } } }) {
   const groupId = route?.params?.groupId;
   const toast = useToastStore((state) => state.show);

apps/mobile/app/screens/AddExpenseScreen.tsx

@@ -55,6 +55,17 @@ const STEPS = [
   { title: 'Review', subtitle: 'Vibe check before we post?' },
 ];
 
+/**
+ * Multi-step screen for creating an expense within a group.
+ *
+ * Renders a five-step flow to enter expense details, choose a payer, select participants,
+ * configure the split (equal/exact/percentage), optionally enable recurring settings,
+ * review the summary, and create the expense.
+ *
+ * @param route - Screen route with `params.groupId` identifying the target group
+ * @param navigation - Navigation object with `goBack()` for dismissing the screen
+ * @returns The React element for the Add Expense screen
+ */
 export function AddExpenseScreen({
   route,
   navigation,

apps/mobile/app/screens/ExpenseDetailScreen.tsx

@@ -43,6 +43,15 @@ function inferExtension(asset: ImagePicker.ImagePickerAsset): string | undefined
   return 'jpg';
 }
 
+/**
+ * Render the expense detail screen allowing viewing, editing, and receipt upload for a single expense.
+ *
+ * Fetches and displays an expense by `route.params.expenseId`, provides inline editing of description and category,
+ * and supports attaching or replacing a receipt image with size and permission checks.
+ *
+ * @param route - Navigation route object whose `params.expenseId` is the ID of the expense to display
+ * @returns A React element that renders the expense detail screen
+ */
 export function ExpenseDetailScreen({ route }: { route: { params: { expenseId: string } } }) {
   const [loading, setLoading] = React.useState(true);
   const [expense, setExpense] = React.useState<ExpenseDto | null>(null);

apps/mobile/app/screens/GroupDetailScreen.tsx

@@ -80,6 +80,15 @@ const getBalanceStatus = (value: number) => {
   return 'All settled';
 };
 
+/**
+ * Screen component that displays a group's details, balances, expenses, recurring bills, members, and related actions.
+ *
+ * Loads group data and expenses, provides filtering and grouping of expenses, editing/removing recurring bills, exporting CSV, and navigation to related screens.
+ *
+ * @param route - Route object whose `params.groupId` selects the group to show
+ * @param navigation - Navigation object used to navigate to other screens (e.g., AddExpense, ExpenseDetail, GroupMembers)
+ * @returns The rendered Group detail screen element
+ */
 export function GroupDetailScreen({
   route,
   navigation,

apps/mobile/app/screens/GuestGroupDetailScreen.tsx

@@ -12,6 +12,17 @@ import { ExpenseCard } from '../components/ExpenseCard';
 import { SectionHeader } from '../components/SectionHeader';
 import { useToastStore } from '../store/toastStore';
 
+/**
+ * Render a view-only detail screen for a shared group link.
+ *
+ * Fetches group details, summary statistics, recent expenses, members, and recent activity for the guest token;
+ * displays loading and error states, a read-only UI with stats, recent expenses, and activity history,
+ * and offers a prompt to register. On fetch failure a toast is shown and navigation goes back.
+ *
+ * @param route - The navigation route; expects `route.params.token` containing the shared guest token.
+ * @param navigation - Navigation object used to go back on error and navigate to the Register screen.
+ * @returns A `JSX.Element` representing the guest group detail screen.
+ */
 export function GuestGroupDetailScreen({ route, navigation }: { route: any; navigation: any }) {
   const { token } = route.params;
   const { colors, typography, shadows } = useAppTheme();

apps/mobile/app/screens/HomeScreen.tsx

@@ -100,6 +100,14 @@ const subtitleForActivity = (activity: ActivityDto): string => {
   }
 };
 
+/**
+ * Renders the app's dashboard home screen with summary, quick actions, attention items, and recent activity.
+ *
+ * Loads user summary, recent activities, and per-group attention items on mount; displays a balance card, quick action tiles, a "Needs Attention" list (when present), and a recent activity feed with navigation handlers for related screens.
+ *
+ * @param navigation - React Navigation prop used to navigate to other screens (e.g., 'AddExpense', 'Groups', 'SettleUp', 'GroupDetail', 'Activity', 'Profile')
+ * @returns The Home screen React element
+ */
 export function HomeScreen({ navigation }: { navigation: any }) {
   const user = useAuthStore((state) => state.user);
   const groups = useGroupStore((state) => state.groups);

apps/web/app/dashboard/activity/page.tsx

@@ -5,6 +5,14 @@ import { backendFetch } from '../../../src/lib/backend';
 
 type ActivityResponse = { items: ActivityDto[]; nextCursor: number | null };
 
+/**
+ * Render the Activity page, fetching groups and an initial page of activity items before rendering the feed.
+ *
+ * If fetching groups or activity fails, errors are suppressed and the corresponding data defaults to an empty list
+ * (for groups) or an empty activity response with `items: []` and `nextCursor: null` (for activity).
+ *
+ * @returns A React element containing the dashboard-styled Activity page with the fetched groups and initial activity items.
+ */
 export default async function ActivityPage() {
   let groups: GroupDto[] = [];
   let activity: ActivityResponse = { items: [], nextCursor: null };

apps/web/app/dashboard/groups/[groupId]/page.tsx

@@ -22,6 +22,12 @@ interface GroupDetailPageProps {
   }>;
 }
 
+/**
+ * Renders the group detail dashboard for a specified group.
+ *
+ * @param params - A Promise that resolves to an object containing `groupId`, used to fetch all data for the group.
+ * @returns The page JSX showing the group header (name, creation date, currency, member count, total spend), current user's balance status, summary panel, recurring expenses, expense table, member list, and group actions.
+ */
 export default async function GroupDetailPage({ params }: GroupDetailPageProps) {
   const { groupId } = await params;
 

apps/web/app/dashboard/page.tsx

@@ -17,6 +17,17 @@ import { GlassCard } from '../../components/ui/GlassCard';
 
 type Group = { id: string; name: string; currency: string };
 
+/**
+ * Format an amount given in cents into a localized currency string.
+ *
+ * If `cents` or `currency` is missing, returns "$0.00". For supported currency codes
+ * "USD", "EUR", and "INR" the value is formatted using that currency; for any other
+ * currency code the value is formatted using "USD" as a fallback.
+ *
+ * @param cents - The amount in the smallest currency unit (cents) as a string, or `null`
+ * @param currency - An ISO currency code (e.g., "USD", "EUR", "INR"), or `null`
+ * @returns A formatted currency string (for example, "$1.23")
+ */
 function formatMoney(cents: string | null, currency: string | null): string {
   if (!cents || !currency) {
     return '$0.00';
@@ -29,6 +40,13 @@ function formatMoney(cents: string | null, currency: string | null): string {
   return formatCurrencyFromCents(cents, 'USD');
 }
 
+/**
+ * Render the dashboard page showing account summaries, attention items, activity, charts, and group listings.
+ *
+ * Fetches dashboard and recent-activity data, derives view state (summary cards, attention queue, recent activity, and groups), and returns the assembled UI layout.
+ *
+ * @returns The dashboard page JSX element that displays summaries, an attention queue (when present), spending chart, quick actions, recent activity, and a list of groups.
+ */
 export default async function DashboardPage() {
   const [dashboard, recentActivityData] = await Promise.all([
     backendFetch<GroupDashboardDto>('/groups/dashboard'),