Contentstack Dart Sdk

Contentstack Dart SDK (API) – Contentstack Dart SDK

When to use

• Adding or changing exported types in lib/contentstack.dart
• Working on Stack, content types, entries, queries, assets, image transforms, sync, or live preview
• Defining or handling SDK errors and response models

Instructions

Entry points

• Main library: lib/contentstack.dart re-exports src/ modules—prefer exporting new public types from there
• Core client: lib/src/stack.dart and related entry.dart, query.dart, contenttype.dart, asset.dart, image_transform.dart

API boundaries

• This package targets Content Delivery API usage (read/query published content), not Management API operations
• HTTP is performed via the http package; see ../runtime-and-http/SKILL.md

Models and errors

• JSON models use json_annotation + generated *.g.dart parts—regenerate after schema changes (see ../dev-workflow/SKILL.md)
• Errors live under lib/src/error/; keep messages and types consistent with CDA behavior

Versioning

• Package version and changelog: follow semver in pubspec.yaml and CHANGELOG.md when releasing

References

• Content Delivery API
• ../dart-style/SKILL.md — imports and docs
• ../testing/SKILL.md — integration-style tests