Skip to content

v2.0.2 - InstantDB v0.4.0 Schema Management CLI

Choose a tag to compare

@pillowsoft pillowsoft released this 03 Jan 12:58
· 10 commits to main since this release

⬆️ v2.0.2 - InstantDB v0.4.0 Schema Management CLI

This patch release upgrades InstantDB Flutter to v0.4.0, adding comprehensive schema management capabilities.


🆕 What's New

InstantDB Flutter v0.3.4 → v0.4.0

Schema Management CLI Tool

The InstantDB package now includes a complete CLI for managing database schemas:

# Pull schemas from cloud
dart run instantdb_flutter:schema pull

# Push schemas to cloud
dart run instantdb_flutter:schema push

# View local schema files
dart run instantdb_flutter:schema status

# Validate Dart schema syntax
dart run instantdb_flutter:schema validate

# Display help information
dart run instantdb_flutter:schema help

Features:

  • 🎨 Color-coded terminal output for different message types
  • 🔒 Interactive confirmations for destructive operations
  • 📁 Custom schema file path support via --schema-file flag
  • 🆔 App ID override functionality with --app-id flag
  • 🔍 Verbose logging mode for debugging
  • 🔧 Support for justfile/Make scripts integration
  • 📦 npm package.json scripts compatibility

Requirements:

  • Node.js and npx must be installed
  • Authentication: npx instant-cli@latest login
  • Environment variable: export INSTANT_APP_ID=your-app-id

📋 Changes

Upgraded

  • InstantDB Flutter: v0.3.4 → v0.4.0

Added

  • Schema management CLI commands
  • Interactive schema operations
  • Custom configuration options

✅ Compatibility

  • No breaking changes - Full backward compatibility
  • Tests passing - 15+ tests, expected platform skips
  • All platforms supported - iOS, Android, Web, macOS, Windows, Linux

🔗 References


📚 Schema Management Quick Start

1. Setup

# Install Node.js CLI (one-time)
npx instant-cli@latest login

# Set your app ID
export INSTANT_APP_ID=your-app-id-here

2. Pull Schema from Cloud

dart run instantdb_flutter:schema pull

3. Push Schema to Cloud

dart run instantdb_flutter:schema push

4. Validate Local Schema

dart run instantdb_flutter:schema validate

5. Custom Schema File

dart run instantdb_flutter:schema pull --schema-file=custom/path/schema.dart

🚀 Previous Releases

This release builds on v2.0.1 which included:

  • InstantDB v0.3.4 bug fixes (clearAll crash, performance indexing)
  • All v2.0.0 security fixes and improvements

See v2.0.1 Release Notes for details.