feat: comprehensive improvements across CLI, client, core, and shared…

[weroperking]

… packages

• Enhanced CLI commands with improved prompts, context generation, and error handling
• Updated client library with better authentication, query building, and storage support
• Improved core functionality for RLS, GraphQL, webhooks, and database providers
• Added biome.json for code formatting
• Updated templates with latest improvements
• Added betterbase_real_world_project_creation.md documentation

Summary by CodeRabbit

• New Features

  • Added TaskFlow reference project—a comprehensive Phase 2 scaffold demonstrating real-world task management with data models, access control, webhooks, GraphQL, edge functions, and end-to-end testing guidance.
  • Introduced code formatting configuration with Biome.

• Documentation

  • New TaskFlow scaffold documentation with complete implementation patterns and project structure.

• Refactor

  • Standardized code formatting across packages (quote style, indentation, and semicolons).
  • Auth client API updated to accept URL parameter per method call.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between fee82b3 and 71fb409.

📒 Files selected for processing (119)

• .devcontainer/devcontainer.json
• .kilocode/mcp.json
• betterbase_real_world_project_creation.md
• biome.json
• package.json
• packages/cli/package.json
• packages/cli/src/build.ts
• packages/cli/src/commands/auth.ts
• packages/cli/src/commands/dev.ts
• packages/cli/src/commands/function.ts
• packages/cli/src/commands/generate.ts
• packages/cli/src/commands/graphql.ts
• packages/cli/src/commands/init.ts
• packages/cli/src/commands/migrate.ts
• packages/cli/src/commands/rls.ts
• packages/cli/src/commands/storage.ts
• packages/cli/src/commands/webhook.ts
• packages/cli/src/constants.ts
• packages/cli/src/index.ts
• packages/cli/src/utils/context-generator.ts
• packages/cli/src/utils/logger.ts
• packages/cli/src/utils/prompts.ts
• packages/cli/src/utils/provider-prompts.ts
• packages/cli/src/utils/route-scanner.ts
• packages/cli/src/utils/scanner.ts
• packages/cli/src/utils/schema-scanner.ts
• packages/cli/test/context-generator.test.ts
• packages/cli/test/route-scanner.test.ts
• packages/cli/test/scanner.test.ts
• packages/cli/test/smoke.test.ts
• packages/cli/tsconfig.json
• packages/client/package.json
• packages/client/src/auth.ts
• packages/client/src/build.ts
• packages/client/src/client.ts
• packages/client/src/errors.ts
• packages/client/src/index.ts
• packages/client/src/query-builder.ts
• packages/client/src/realtime.ts
• packages/client/src/storage.ts
• packages/client/src/types.ts
• packages/client/test/client.test.ts
• packages/client/tsconfig.json
• packages/client/tsconfig.test.json
• packages/core/package.json
• packages/core/src/config/drizzle-generator.ts
• packages/core/src/config/index.ts
• packages/core/src/config/schema.ts
• packages/core/src/functions/bundler.ts
• packages/core/src/functions/deployer.ts
• packages/core/src/functions/index.ts
• packages/core/src/graphql/index.ts
• packages/core/src/graphql/resolvers.ts
• packages/core/src/graphql/schema-generator.ts
• packages/core/src/graphql/sdl-exporter.ts
• packages/core/src/graphql/server.ts
• packages/core/src/index.ts
• packages/core/src/middleware/index.ts
• packages/core/src/middleware/rls-session.ts
• packages/core/src/migration/index.ts
• packages/core/src/migration/rls-migrator.ts
• packages/core/src/providers/index.ts
• packages/core/src/providers/neon.ts
• packages/core/src/providers/planetscale.ts
• packages/core/src/providers/postgres.ts
• packages/core/src/providers/supabase.ts
• packages/core/src/providers/turso.ts
• packages/core/src/providers/types.ts
• packages/core/src/rls/auth-bridge.ts
• packages/core/src/rls/generator.ts
• packages/core/src/rls/index.ts
• packages/core/src/rls/scanner.ts
• packages/core/src/rls/types.ts
• packages/core/src/storage/index.ts
• packages/core/src/storage/s3-adapter.ts
• packages/core/src/storage/types.ts
• packages/core/src/webhooks/dispatcher.ts
• packages/core/src/webhooks/index.ts
• packages/core/src/webhooks/integrator.ts
• packages/core/src/webhooks/signer.ts
• packages/core/src/webhooks/startup.ts
• packages/core/src/webhooks/types.ts
• packages/core/tsconfig.json
• packages/shared/package.json
• packages/shared/src/constants.ts
• packages/shared/src/errors.ts
• packages/shared/src/index.ts
• packages/shared/src/types.ts
• packages/shared/src/utils.ts
• packages/shared/tsconfig.json
• templates/auth/src/auth/index.ts
• templates/auth/src/auth/types.ts
• templates/auth/src/db/auth-schema.ts
• templates/auth/src/db/index.ts
• templates/auth/src/db/schema.ts
• templates/auth/src/middleware/auth.ts
• templates/auth/src/routes/auth-example.ts
• templates/auth/src/routes/auth.ts
• templates/base/betterbase.config.ts
• templates/base/drizzle.config.ts
• templates/base/package.json
• templates/base/src/auth/index.ts
• templates/base/src/auth/types.ts
• templates/base/src/db/index.ts
• templates/base/src/db/migrate.ts
• templates/base/src/db/schema.ts
• templates/base/src/index.ts
• templates/base/src/lib/env.ts
• templates/base/src/lib/realtime.ts
• templates/base/src/middleware/auth.ts
• templates/base/src/middleware/validation.ts
• templates/base/src/routes/graphql.d.ts
• templates/base/src/routes/health.ts
• templates/base/src/routes/index.ts
• templates/base/src/routes/storage.ts
• templates/base/src/routes/users.ts
• templates/base/tsconfig.json
• tsconfig.base.json
• turbo.json

---

📝 Walkthrough

Walkthrough

Comprehensive formatting and style standardization across the codebase (quotes, indentation, semicolons) spanning configuration files, CLI commands, client SDK, and core packages, alongside GraphQL/auth API refinements and a new TaskFlow reference project scaffold document.

Changes

Cohort / File(s)	Summary
Configuration & Manifest Files .devcontainer/devcontainer.json, .kilocode/mcp.json, biome.json, package.json, packages/*/package.json, packages/*/tsconfig*.json	Formatting adjustments (indentation, whitespace, quote consistency) with no functional changes. Biome config introduces linting rules; core package.json version bumped to 2.6.3 with node build target added.
CLI Base & Utilities packages/cli/src/index.ts, packages/cli/src/constants.ts, packages/cli/src/utils/logger.ts, packages/cli/src/utils/schema-scanner.ts	Import reordering, quote normalization, and indentation alignment without behavioral changes. DEFAULT_DB_PATH quote style updated.
CLI Commands - Auth, Dev, Build packages/cli/src/build.ts, packages/cli/src/commands/auth.ts, packages/cli/src/commands/dev.ts	Minor formatting, trailing commas in function parameters, consistent string quotes. No control-flow changes.
CLI Commands - Function packages/cli/src/commands/function.ts	Reordered imports with explicit type exports; added return type annotations to internal functions; quote normalization and formatting adjustments. Logic preserved.
CLI Commands - Generate, GraphQL, Init, Migrate packages/cli/src/commands/generate.ts, packages/cli/src/commands/graphql.ts, packages/cli/src/commands/init.ts, packages/cli/src/commands/migrate.ts	Formatting standardization (quotes, indentation, semicolons), some loop refactoring (for...of instead of forEach), maintained core logic and return values.
CLI Commands - RLS, Storage, Webhook packages/cli/src/commands/rls.ts, packages/cli/src/commands/storage.ts, packages/cli/src/commands/webhook.ts	Quote and semicolon normalization. Webhook command refactored with async/await pattern for config file loading (readConfigFile now async); other files retain logic with formatting updates.
CLI Utils - Scanner, Route Scanner, Prompts packages/cli/src/utils/scanner.ts, packages/cli/src/utils/route-scanner.ts, packages/cli/src/utils/prompts.ts, packages/cli/src/utils/provider-prompts.ts, packages/cli/src/utils/context-generator.ts	Formatting updates (quotes, indentation), minor type refinements in scanner. Core parsing and validation logic preserved; SchemaScanner adds private sourceFile field for caching.
CLI Tests packages/cli/test/context-generator.test.ts, packages/cli/test/route-scanner.test.ts, packages/cli/test/scanner.test.ts, packages/cli/test/smoke.test.ts	Quote standardization and indentation adjustments. Test assertions simplified in context-generator tests (focus on empty-state scenarios); other tests retain logic.
Client SDK - Auth & Client packages/client/src/auth.ts, packages/client/src/client.ts	Auth methods (signUp, signIn, signOut, getSession) updated to require URL parameter. Minor formatting; public User/Session interfaces formatted with semicolons.
Client SDK - Build, Errors, Index packages/client/src/build.ts, packages/client/src/errors.ts, packages/client/src/index.ts	Build script adds externals for bundling (@betterbase/core, @betterbase/shared, better-auth). Minor formatting and quote normalization; no API changes.
Client SDK - Query Builder, Realtime, Storage, Types packages/client/src/query-builder.ts, packages/client/src/realtime.ts, packages/client/src/storage.ts, packages/client/src/types.ts	Formatting and quote normalization. RealtimeClient constructor formatted with trailing comma (semantically equivalent). Storage class spacing adjusted. Type literal quotes updated.
Client Tests packages/client/test/client.test.ts	Quote standardization and minor indentation; test logic unchanged.
Core Config packages/core/src/config/drizzle-generator.ts, packages/core/src/config/schema.ts, packages/core/src/config/index.ts	DrizzleDriver and DrizzleDialect types updated to double quotes with inline comments. DbCredentials and DrizzleConfigOutput interfaces use semicolon terminators. BetterBaseConfigSchema restructured from chained .superRefine to flat object + separate .superRefine (preserves validation).
Core Functions packages/core/src/functions/bundler.ts, packages/core/src/functions/deployer.ts, packages/core/src/functions/index.ts	Import and quote formatting; no API or control-flow changes. Bundler and deployer logic preserved with stylistic updates.
Core GraphQL packages/core/src/graphql/index.ts, packages/core/src/graphql/resolvers.ts, packages/core/src/graphql/schema-generator.ts, packages/core/src/graphql/sdl-exporter.ts, packages/core/src/graphql/server.ts	Restructured imports (explicit type-only and value imports). GraphQLConfig interface refined (getUser signature adjusted). createGraphQLServer return types updated (app: Hono; yoga: YogaServerInstance). SDL exporter refactored with new internal helpers. Scalar and type mapping logic preserved.
Core Middleware & Migration packages/core/src/middleware/index.ts, packages/core/src/middleware/rls-session.ts, packages/core/src/migration/index.ts, packages/core/src/index.ts	Import reformatting and quote updates. RLS session and migration logic preserved; only formatting and semicolon adjustments applied.
Reference Documentation betterbase_real_world_project_creation.md	New comprehensive Phase 2 TaskFlow scaffold: includes PostgreSQL schema (users, projects, tasks, comments, project_members), RBAC/RLS policies, migrations, CRUD scaffolding, webhooks, storage integration, GraphQL setup, edge functions, end-to-end testing workflow, and project structure with feature flags confirmation.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

• PR #18: Introduces Drizzle DB schema and RLS policies that the GraphQL generator and CLI directly consume for SDL/resolver generation.
• PR #12: Modifies BetterBaseConfigSchema validation logic in the same configuration module as this PR.
• PR #20: Both PRs modify function-related CLI commands and core function exports in overlapping ways.

Suggested labels

formatting, refactor, documentation

---

🐰 Hops through the code with glee,
Tabs and quotes now unified be,
Semicolons dance in a perfect row,
Auth takes a URL, now watch it go!
GraphQL's schema shines crystal clear,
A TaskFlow reference brings all cheer! ✨

✨ Finishing Touches

• 📝 Generate docstrings (stacked PR)
• 📝 Generate docstrings (commit on current branch)

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feature/comprehensive-improvements-20260301

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}