Basic Queries

Learn how to fetch content with the GitCMS Client SDK.

Query by Schema

Use from() to query content by schema type:

const posts = await cms.from('posts').get();

Get Single Document

From Schema

const post = await cms.from('posts').doc('my-post-id').get();

Standalone Document

const config = await cms.doc('site-config').get();

Simple Filtering

Equality

const published = await cms
  .from('posts')
  .where('status', '==', 'published')
  .get();

Boolean Fields

const featured = await cms.from('posts').where('featured', true).get();

Nested Fields

const published = await cms
  .from('posts')
  .where('metadata.status', '==', 'published')
  .get();

Multiple Filters

Chain where() calls to combine filters:

const results = await cms
  .from('posts')
  .where('metadata.status', '==', 'published')
  .where('featured', true)
  .get();

Content Structure

Content is returned with this structure:

{
  id: string;
  schemaId: string;
  data: {
    // Your content fields
    title: string;
    content: string;
    // ...
  }
  metadata: {
    status: 'draft' | 'published' | 'archived';
    publishedAt: string;
    // ...
  }
}

Accessing Fields

const posts = await cms.from('posts').get();

posts.forEach(post => {
  console.log(post.id); // Post ID
  console.log(post.data.title); // Title
  console.log(post.metadata.status); // Status
  console.log(post.metadata.publishedAt); // Date
});

Next Steps

Learn More

• Filtering - Advanced queries
• Sorting & Limiting - Order results
• Nested Fields - Deep access