Tooltip(
  message: 'Добавить',
  child: Icon(Icons.add),
)

    Tooltip(
  decoration: BoxDecoration(
    color: Theme.of(context).colorScheme.surface,
  ),
  richMessage: WidgetSpan(
    alignment: PlaceholderAlignment.baseline,
    baseline: TextBaseline.alphabetic,
    child: Padding(
      padding: const EdgeInsets.all(4.0),
      child: ConstrainedBox(
        constraints: BoxConstraints(maxWidth: maxWidth),
        child: Text(
          message,
          style: Theme.of(context).textTheme.bodySmall,
        ),
      ),
    ),
  ),
  child: const InfoIcon(isOutline: true, size: 20),
);

IconButton(
  icon: Icon(Icons.search),
  tooltip: 'Поиск',
  onPressed: () {},
)

git checkout -b feature/new-cool-widget
# Работаешь, коммитишь
git add .
git commit -m "Добавил новый виджет для экрана авторизации"
git push origin feature/new-cool-widget

Лайфхак: ⌘ + K (macOS) или Ctrl + K (Windows/Linux) — быстрое окно коммита

Лайфхак: Cmd + Shift + P → Git: Commit — и вуаля, можно коммитить без мышки

gitignore
# Flutter
.dart_tool/
.packages
.pub/
build/
ios/Pods/
android/.gradle/

class Example extends StatelessWidget {
  const Example({super.key});

  @override
  Widget build(BuildContext context) {
    return Column(
      children: [
        const Text('Example text'), // оптимально
        Text('Example text not const'), // можно оптимизировать, добавив const
      ],
    );
  }
}

/// Пример неоптимизированного использования
class NotOptimizedExample extends StatelessWidget {
  const NotOptimizedExample({super.key});

  @override
  Widget build(BuildContext context) {
    return Container(
      width: MediaQuery.of(context).size.width * 0.8,
      height: MediaQuery.of(context).size.height * 0.3,
      margin: EdgeInsets.all(MediaQuery.of(context).size.width * 0.05),
      decoration: BoxDecoration(
        color: Theme.of(context).primaryColor,
        border: Border.all(color: Theme.of(context).dividerColor),
      ),
      child: const Text('Hello'),
    );
  }
}

/// Пример оптимизированного использования
class OptimizedExample extends StatelessWidget {
  const OptimizedExample({super.key});

  @override
  Widget build(BuildContext context) {
    final sizeData = MediaQuery.sizeOf(context);
    final themeData = Theme.of(context);

    return Container(
      width: sizeData.width * 0.8,
      height: sizeData.height * 0.3,
      margin: EdgeInsets.all(sizeData.width * 0.05),
      decoration: BoxDecoration(
        color: themeData.primaryColor,
        border: Border.all(color: themeData.dividerColor),
      ),
      child: const Text('Hello'),
    );
  }
}

class _NotOptimizedExampleState extends State<NotOptimizedExample> {
  int counter = 0;

  @override
  Widget build(BuildContext context) {
    return Column(
      children: [
        PageHeader(), // Пересоздается
        CounterView(),
        CounterButton(
          onTap: () => setState(() {
            counter++;
          }),
        ),
        PageFooter(), // Пересоздается
      ],
    );
  }
}

Future<String> fetchData() {
  return Future.delayed(Duration(seconds: 2), () => 'Data loaded');
}

import 'package:fake_async/fake_async.dart';
import 'package:test/test.dart';

void main() {
  test('fetchData должен вернуть "Data loaded" через 2 секунды', () {
    fakeAsync((async) { // 1. Оборачиваем тест в fakeAsync()
      final future = fetchData();

      async.elapse(Duration(seconds: 2)); // 2. Перемещаем виртуальное время на 2 секунды

      expect(future, completion('Data loaded')); // 3. Немедленно проверяем результат
    });
  });
}

Semantics(
  role: SemanticsRole.list,
  explicitChildNodes: true,
  child: Column(
    children: [
      Semantics(
        role: SemanticsRole.listItem,
        child: Text('Первый элемент списка'),
      ),
      Semantics(
        role: SemanticsRole.listItem,
        child: Text('Второй элемент списка'),
      ),
    ],
  ),
)

flutter run -d chrome --profile --dart-define=FLUTTER_WEB_DEBUG_SHOW_SEMANTICS=true

class AnalyticsService {
  Future<void> init(String apiKey) async {
    await AppMetrica.activate(AppMetricaConfig(apiKey));
  }

  Future<void> reportEvent(String event) async {
    await AppMetrica.reportEvent(event);
  }
}

'add_product_to_cart', {
  'screen': 'main',
  'product_id': '123'
}

enum DownloadStatus {
  notDownloaded,
  fetchingDownload,
  downloading,
  downloaded,
}

AnimatedContainer(
  duration: transitionDuration,
  decoration: ShapeDecoration(
    shape: isDownloading || isFetching
        ? CircleBorder()
        : StadiumBorder(),
    color: isDownloading || isFetching
        ? Colors.transparent
        : CupertinoColors.lightBackgroundGray,
  ),
  child: ...
);

AnimatedOpacity(
  opacity: isDownloading || isFetching ? 0.0 : 1.0,
  duration: transitionDuration,
  child: Text(
    isDownloaded ? 'OPEN' : 'GET',
    style: TextStyle(
      fontWeight: FontWeight.bold,
      color: CupertinoColors.activeBlue,
    ),
  ),
);

Stack(
  alignment: Alignment.center,
  children: [
    CircularProgressIndicator(value: progress),
    if (isDownloading)
      Icon(Icons.stop, size: 14, color: CupertinoColors.activeBlue),
  ],
);

void _onPressed() {
  switch (status) {
    case DownloadStatus.notDownloaded:
      onDownload();
      break;
    case DownloadStatus.downloading:
      onCancel();
      break;
    case DownloadStatus.downloaded:
      onOpen();
      break;
    case DownloadStatus.fetchingDownload:
      break;
  }
}

assets
|-- images
     |-- feature_1
     |-- feature_2
|-- icons
     |-- bottom_navigation_bar
     |-- features
          |-- feature_1
          |-- feature_2 

flutter widget-preview start

class CustomCard extends StatelessWidget {
  @Preview()
  const CustomCard({super.key});

  @override
  Widget build(BuildContext context) {
    return Card(
      child: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Row(
          children: [
            Container(
              height: 80,
              width: 80,
              decoration: BoxDecoration(
                borderRadius: BorderRadius.circular(16.0),
                image: const DecorationImage(
                  image: NetworkImage(
                    'https://images.unsplash.com/photo-1755133314246-2103970d4726?q=80&w=988&auto=format&fit=crop&ixlib=rb-4.1.0&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D',
                  ),
                  fit: BoxFit.cover,
                ),
              ),
            ),
            const SizedBox(width: 16),
            const Column(
                crossAxisAlignment: CrossAxisAlignment.start,
              children: [
                Text(
                  'Фото #2345',
                  style: TextStyle(fontSize: 20),
                ),
                SizedBox(width: 16),
                Text(
                  'Описание к фотографии #2345',
                  style: TextStyle(fontSize: 16),
                ),
              ],
            ),
          ],
        ),
      ),
    );
  }
}

npx create-docusaurus@latest my-website classic

my-website  
├── blog  
├── docs  
├── src  
├── static  
├── docusaurus.config.js  
├── package.json  
└── sidebars.js

npm install

npx docusaurus start

npm run build

npm run serve