Appwrite Service Layer Pattern

implementing-service-layer

Defines a pattern for abstracting Appwrite database calls into dedicated service files. Use to keep components clean and reusable.

itsmeAlee/Tourly2·0installs0stars

SKILL.md

Full skill instructions

Appwrite Service Layer Pattern

When to use this skill

Before writing database logic in a component.
When a database query needs to be reused across multiple pages or actions.

Folder Structure

services/tours.ts
services/bookings.ts
services/auth.ts

Example Pattern

import { databases, DATABASE_ID, COLLECTIONS } from '@/lib/appwrite';
import { Query } from 'appwrite';
import { Tour } from '@/types';

export const TourService = {
    async getAll(limit = 10) {
        return await databases.listDocuments<Tour>(
            DATABASE_ID,
            COLLECTIONS.TOURS,
            [Query.limit(limit), Query.orderDesc('$createdAt')]
        );
    },
    async getById(id: string) {
        return await databases.getDocument<Tour>(DATABASE_ID, COLLECTIONS.TOURS, id);
    }
};

Instructions

Abstraction: Components should call TourService.getAll() rather than the Appwrite SDK directly.
Error Handling: Catch errors in the service or re-throw them with descriptive messages.

Install skill

Copy and run in your terminal

npx -y skills add https://github.com/itsmeAlee/Tourly2 --skill implementing-service-layer

View on GitHub

.agent/skills/implementing-service-layer/SKILL.md

managing-date-selection
Implements the "Restart Logic" for date range selection in the Tourly search widget. Use when building or modifying the date picker, handling check-in/check-out dates, or implementing calendar interaction algorithms.
0 installs
handling-deploy-cicd
Deployment protocols for Vercel/Appwrite. Use for managing production builds and environment variables.
0 installs
formatting-api-responses
Standardizes the structure of internal function results. Use when writing Services or Server Actions.
0 installs
writing-utility-helpers
Standardizes frequent utility functions for currency, dates, and strings. Use to maintain consistency in formatting.
0 installs

More skills from itsmeAlee

itsmeAlee/Tourly2

optimizing-iconography

Rules for using icons efficiently to maintain performance. Use when adding icons from Lucide React.

0 0

View

itsmeAlee/Tourly2

handling-data-fetching

Strategy for fetching data using React Server Components (RSC) and managing cache. Use for initial page loads and SEO-optimized data.

0 0

View

itsmeAlee/Tourly2

managing-design-system

Defines the core visual identity, color tokens, interaction patterns, and signature UI layouts for Tourly. Use when implementing or styling any frontend component to ensure brand consistency.

0 0

View

itsmeAlee/Tourly2