flutter-query-lint

Validate Supabase queries in Flutter API files against database schema definitions.

1|Updated Jan 8, 2026
One-click install
npx skills add https://github.com/JaveedIshaq/ai-workflow-orchestrator --skill flutter-query-lint
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: flutter-query-lint
Source: https://github.com/JaveedIshaq/ai-workflow-orchestrator/tree/main/skills/ballee/flutter-query-lint
Command: npx skills add https://github.com/JaveedIshaq/ai-workflow-orchestrator --skill flutter-query-lint

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill prevents runtime errors in your Flutter application by validating Supabase database queries against your actual database schema before deployment.

Core Features & Use Cases

  • Schema Validation: Checks table names, column names, and relationships in your Flutter API calls against database.types.ts.
  • RPC Function Check: Verifies that all .rpc() calls in your Flutter code correspond to existing database functions.
  • Use Case: Before merging a pull request that modifies how your mobile app interacts with the database, run this linter to catch any typos or schema mismatches that would otherwise cause user-facing errors.

Quick Start

Run the linter from your project's root directory using the command: npx ts-node .claude/skills/flutter-query-lint/scripts/lint-queries.ts

Frequently Asked Questions about flutter-query-lint

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate Flutter Supabase queries against my database schema?▼

You can validate Flutter Supabase queries by running a linter script that cross-references your API files against `database.types.ts`. This process checks table names, columns, and relationships to prevent runtime errors before deployment.

What is Supabase query validation in Flutter?▼

Supabase query validation verifies that table names, columns, and `.rpc()` calls in your Flutter code match the actual database schema definition. It identifies mismatches early to ensure code integrity and prevent user-facing failures.

Can I check for non-existent Supabase tables and columns in Flutter code before merging?▼

Yes, you can check for non-existent tables and columns by cross-referencing your Flutter API files with `database.types.ts`. The linter identifies and reports schema mismatches, making it ideal for catching errors before merging a pull request.

How do I verify Supabase RPC function calls in a Flutter application?▼

You verify Supabase RPC function calls by running a linter that checks your Flutter code against existing database functions. It ensures that every `.rpc()` call corresponds to a defined function in your database schema.

Do I need a `database.types.ts` file to lint Supabase queries in Flutter?▼

Yes, you need a `database.types.ts` file to lint Supabase queries effectively. The linter uses this database schema definition as the source of truth to validate tables, columns, and RPC functions referenced in your Flutter API files.