cargo run -p cratestack-cli -- generate-dart \
  --schema examples/react-vite-swr/schema.cstack \
  --out packages/board_client \
  --library-name board_client \
  --base-path /api

cargo run -p cratestack-cli -- generate-dart \
  --schema examples/react-vite-swr/schema.cstack \
  --out examples/flutter-riverpod/client \
  --library-name flutter_riverpod_client \
  --preset riverpod

lib/
  <library_name>.dart          # barrel: exports everything below
  src/
    runtime.dart                # CratestackClientAdapter / CratestackRpcAdapter, request plumbing
    constants.dart               # field-name / include-name constants
    queries.dart                 # CratestackFetchQuery / CratestackListQuery (REST only)
    client.dart                  # top-level client class + xAdapterProvider / xClientProvider
    procedures.dart              # procedure argument classes, ProceduresApi, one @riverpod provider per procedure
    models/
      shared_types.dart          # Page<T> / PageInfo and any type referenced by more than one model
      <model>.dart                # per model: data classes, <Model>Api, one @riverpod provider per operation

final flutterRiverpodClientAdapterProvider = Provider<CratestackClientAdapter>((ref) {
  throw UnimplementedError('Override flutterRiverpodClientAdapterProvider before reading the generated CrateStack client.');
});

final flutterRiverpodClientClientProvider = Provider<FlutterRiverpodClientCratestackClient>((ref) {
  return FlutterRiverpodClientCratestackClient(
    ref.watch(flutterRiverpodClientAdapterProvider),
    basePath: ref.watch(flutterRiverpodClientBasePathProvider),
  );
});

ProviderScope(
  overrides: [
    flutterRiverpodClientAdapterProvider.overrideWithValue(
      CratestackDioAdapter(dio: myDio),
    ),
  ],
  child: const MyApp(),
);

@riverpod
Future<Board> board(
  Ref ref,
  int id, {
  CratestackFetchQuery? query,
}) {
  return ref.watch(flutterRiverpodClientBoardApiProvider).get(id, query: query);
}

@riverpod
Future<IList<Board>> boardList(Ref ref, {
  CratestackListQuery? query,
}) {
  return ref.watch(flutterRiverpodClientBoardApiProvider).list(query: query);
}

@riverpod
class BoardCreateController extends _$BoardCreateController {
  @override
  FutureOr<Board?> build() => null;

  Future<Board> create(CreateBoardInput input) async {
    state = const AsyncValue.loading();
    try {
      final result = await ref.read(flutterRiverpodClientBoardApiProvider).create(input);
      state = AsyncValue.data(result);
      return result;
    } catch (error, stackTrace) {
      state = AsyncValue.error(error, stackTrace);
      rethrow;
    }
  }
}

final published = ref.watch(
  boardListProvider(query: const CratestackListQuery(where: 'published=true', sort: '-id', limit: 20)),
);

cargo run -p cratestack-cli -- generate-dart \
  --schema examples/react-vite-swr/schema.cstack \
  --out examples/flutter-riverpod/client \
  --library-name flutter_riverpod_client \
  --preset riverpod \
  --run-build-runner

cratestack generate-dart --schema schema.cstack --out .
cd . && dart run build_runner build --delete-conflicting-outputs

cratestack generate-dart \
  --schema schema.cstack \
  --out ./client \
  --no-native-cbor

model Board {
  id Int @id
  name String

  @@allow("read", auth() != null)
  @@allow("create", auth() != null)
  @@allow("update", auth() != null)
  @@allow("delete", auth() != null)
}

model Task {
  id Int @id
  title String
  done Boolean
  boardId Int
  board Board @relation(fields:[boardId],references:[id])

  @@allow("read", auth() != null)
  @@allow("create", auth() != null)
  @@allow("update", auth() != null)
  @@allow("delete", auth() != null)
}

type FocusEstimateArgs {
  taskCount Int
  minutesPerTask Int
}

type FocusEstimateResult {
  totalMinutes Int
}

procedure estimateFocusMinutes(args: FocusEstimateArgs): FocusEstimateResult
  @allow(auth() != null)

docker compose up -d postgres
DATABASE_URL=postgres://cratestack:cratestack@localhost:55432/cratestack_test \
  cargo run -p react-vite-swr-example
# -> listening on http://127.0.0.1:3210 (routes under /api)

cargo run -p cratestack-cli -- generate-dart \
  --schema examples/react-vite-swr/schema.cstack \
  --out examples/flutter-riverpod/client \
  --library-name flutter_riverpod_client \
  --preset riverpod \
  --run-build-runner

void main() {
  runApp(
    ProviderScope(
      overrides: [
        flutterRiverpodClientAdapterProvider.overrideWithValue(
          CratestackDioAdapter(dio: buildAppDio()),
        ),
      ],
      child: const RiverpodExampleApp(),
    ),
  );
}

class _BoardsScreenState extends ConsumerState<BoardsScreen> {
  final _nameController = TextEditingController();

  Future<void> _addBoard() async {
    final name = _nameController.text.trim();
    if (name.isEmpty) return;
    await ref.read(boardCreateControllerProvider.notifier).create(
          CreateBoardInput(id: DateTime.now().millisecondsSinceEpoch, name: name),
        );
    _nameController.clear();
    // No hand-written cache invalidation — ordinary Riverpod usage on an
    // already-generated provider.
    ref.invalidate(boardListProvider());
  }

  @override
  Widget build(BuildContext context) {
    final boards = ref.watch(boardListProvider());
    final creating = ref.watch(boardCreateControllerProvider).isLoading;

    return boards.when(
      data: (items) => ListView.builder(
        itemCount: items.length,
        itemBuilder: (context, index) => ListTile(title: Text(items[index].name ?? '')),
      ),
      loading: () => const CircularProgressIndicator(),
      error: (error, _) => Text('Failed to load boards: $error'),
    );
  }
}

@riverpod
Future<IList<Widget>> widgetList(Ref ref, {
  IMap<String, Object?>? input,
}) {
  return ref.watch(tinyRpcClientWidgetApiProvider).list(input: input?.unlock ?? const <String, Object?>{});
}

final image = await client.images.get(
  7,
  computedParams: ImageComputedParams(proxyUrl: ProxyParams(width: 800)),
);

final params = ImageComputedParamsBuilder()
    .proxyUrl(ProxyParams(width: 800))
    .build();