Server Actions and Mutations

Server Actions and Mutations

When to use this skill

• When handling form submissions ('use server').
• When mutating data in Appwrite from the frontend.
• When you need to revalidate the cache after an update.

Workflow

• Create actions in app/​actions/ or directly in the component file.
• Use 'use server' at the top of the function or file.
• Implement try-catch for error handling.
• Call revalidatePath() to refresh the UI.

Code Template (Next.js 15)

'use server'

import { revalidatePath } from 'next/​cache';
import { BookingService } from '@/​services/​bookings';

export async function createBookingAction(formData: FormData) {
    try {
        const tourId = formData.get('tourId') as string;
        // Logic to create booking...
        await BookingService.create({ ... });
        
        revalidatePath('/​dashboard/​bookings');
        return { success: true };
    } catch (error) {
        return { success: false, error: 'Failed to create booking' };
    }
}

Instructions

• Security: Always validate user session/​permissions inside the Server Action.
• Data Refresh: Use revalidatePath for the specific route or revalidateTag for broader invalidation.