toilahuongg/shopify-agents-kit
Overview
This skill is a compact, modern guide for using Mongoose with MongoDB in 2025–2026, covering Mongoose 8.x and 9.x, strict TypeScript integration, and performance best practices. It focuses on TypeScript-first patterns, serverless-friendly connection handling, and query optimizations to reduce latency and resource usage. The advice reflects current engine improvements like native vector search and lower middleware overhead.
How this skill works
The guide explains how to define plain TypeScript interfaces for document shapes and let Mongoose infer hydrated document types via model generics instead of extending Document. It shows schema and model creation, recommended query patterns such as .lean() and projections, and how to add indexes and compound keys for common lookups. It also provides a serverless/edge-friendly singleton connection pattern that caches connections across hot reloads to avoid exhaustion.
When to use it
- Building TypeScript-first Node.js apps with Mongoose 8.x or 9.x where strict typing is required
- Implementing read-heavy endpoints where lean() and projections reduce latency
- Deploying to serverless or edge platforms that can spawn many short-lived processes
- Optimizing query performance with compound indexes and minimal projection fields
- Adding AI features that leverage Mongoose-native vector search capabilities
Best practices
- Define plain interfaces for your data shape and use model<IYourInterface>() — do not extend built-in Document types
- Use .lean() for read-only operations to avoid hydration overhead and improve throughput
- Create compound indexes aligned with your most common query patterns to speed lookups
- Project only required fields to reduce network I/O and serialization costs
- Cache connections in a global singleton for serverless/edge environments to prevent connection exhaustion
Example use cases
- A TypeScript API that returns lists of users using User.find(...).lean() and lightweight projections
- A multi-tenant app indexing organization + email for fast tenant-scoped user lookups
- Serverless Next.js API routes that reuse a cached mongoose connection across cold starts
- An AI feature using Mongoose-native vector search for similarity queries alongside typed document models
FAQ
No. Mongoose 8+ includes improved type inference; relying on the built-in types and using model generics is the recommended approach.
When must I avoid .lean()?
.lean() should be avoided when you need document methods, setters, virtuals, or middleware behavior that requires hydrated Mongoose documents.
23 skills
This skill guides secure, TypeScript-first Mongoose usage with performance best practices for MongoDB, enabling faster, type-safe data access in modern apps.
This skill orchestrates a complete release workflow by validating tests, updating changelog, and tagging versions for seamless deployment.
This skill helps you implement security hardening for Shopify apps by applying authentication, webhook verification, input validation, and data protection
This skill helps you implement Shopify Liquid in Theme App Extensions and Themes by guiding syntax, schema use, and data access for dynamic storefronts.
This skill generates and maintains changelogs in Keep a Changelog format by analyzing commits and producing well-structured release notes.
This skill helps improve TypeScript/JavaScript code quality by detecting smells, applying refactoring patterns, and producing maintainable code.
This skill helps you write clear internal documentation (READMEs, ADRs, contribution guides) that explains why, front-loads context, and guides future
This skill guides you through configuring, verifying, and handling Shopify webhooks to keep data in sync securely.
This skill updates a project's README.md by analyzing the codebase, extracting structure, and generating comprehensive documentation with clear sections.
This skill helps you analyze arguments and construct rigorous proofs using philosophical methods and formal reasoning to improve critical thinking.
This skill helps you build Shopify Polaris Viz charts and themes, enabling accessible, theme-consistent data visualizations in admin dashboards.
This skill guides adding multi-language support to Shopify Apps using i18next, including setup, translation files, and admin context for broad reach.
This skill helps you implement robust server-first form validation using Zod and Conform in Remix apps, ensuring type-safety and Polaris-ready UI.
This skill helps you build Shopify POS UI extensions to add tiles, modals, and blocks across the smart grid and product screens.
This skill performs comprehensive codebase investigation by mapping features, then running parallel subagents to audit risks, dead code, and missing
This skill guides implementing clean architecture in Remix/TypeScript apps, separating web, service, and repository layers for maintainable, testable code.
This skill creates complete Shopify App Store listing content including intro, details, features, subtitle, terms, SEO, and testing steps.
This skill helps you generate, update, or refactor internal project documentation with clarity and accuracy.
This skill guides you through publishing npm packages, including configuration, versioning, dry runs, and post-publish verification.
This skill helps you design Shopify Admin interfaces using Polaris React to deliver a native, accessible, and merchant-focused experience.
This skill helps you implement resilient Shopify integrations by managing rate limits, retry strategies, queues, and circuit breakers.
This skill helps you keep your local branch up to date with the remote by performing fetch and pull --rebase, resolving conflicts as needed.
This skill helps you adopt Remix best practices with React Router v7, server-first data loading, and robust error handling strategies.
