# Very Good Engineering

> Very Good Ventures' engineering guidelines: Flutter and Dart best practices, architecture, testing, and code style.

Every page has a clean Markdown version at the same path with a `.md` extension (e.g. https://engineering.verygood.ventures/general-practices/philosophy.md).

## Architecture

### Architecture

- [Layered Architecture](https://engineering.verygood.ventures/architecture/architecture.md): Architecture best practices.

### Barrel files

- [Barrel Files](https://engineering.verygood.ventures/architecture/barrel_files.md): Best practices for exposing public facing files.

### Ffca

- [Data Layer](https://engineering.verygood.ventures/architecture/ffca/data.md): Data sources, DTOs, and mapping them onto the domain models.
- [Domain Layer](https://engineering.verygood.ventures/architecture/ffca/domain.md): Models, Commands and Queries, repository interfaces, and combining one feature with another.
- [FFCA FAQ](https://engineering.verygood.ventures/architecture/ffca/faq.md): Common questions about applying feature-first clean architecture.
- [Navigation](https://engineering.verygood.ventures/architecture/ffca/navigation.md): How strictly isolated features navigate without importing each other's routes.
- [Feature-First Clean Architecture](https://engineering.verygood.ventures/architecture/ffca/overview.md): An architecture for Flutter monorepos where features are packages that apps compose.
- [Presentation Layer](https://engineering.verygood.ventures/architecture/ffca/presentation.md): Modules, localizations, and subfeature barrel files in a feature's presentation package.
- [Project Structure](https://engineering.verygood.ventures/architecture/ffca/project_structure.md): Dependency rules, naming conventions, folder layout, and monorepo tooling for an FFCA project.

## Development

### CI/CD

- [CI/CD](https://engineering.verygood.ventures/development/ci_cd.md): Best practices for building CI/CD pipelines.

### Code style

- [Code Style](https://engineering.verygood.ventures/development/code_style.md): Best practices for general code styling that goes beyond linter rules.

### Documentation

- [Code Documentation](https://engineering.verygood.ventures/development/documentation/code_documentation.md): Documentation best practices in code.
- [Documentation](https://engineering.verygood.ventures/development/documentation/documentation.md): Documentation and Code practices that scale.

### Error handling

- [Error handling](https://engineering.verygood.ventures/development/error_handling.md): Error handling best practices.

### Internationalization

- [Localization](https://engineering.verygood.ventures/development/internationalization/localization.md): Recommended practices to localize software and make it accessible in multiple languages.
- [Text Directionality](https://engineering.verygood.ventures/development/internationalization/text_directionality.md): Handling left-to-right and right-to-left content in Flutter.

### State management

- [Bloc Event Transformers](https://engineering.verygood.ventures/development/state_management/bloc_event_transformers.md): Specifying the order in which Bloc events are handled.
- [State Handling](https://engineering.verygood.ventures/development/state_management/bloc_state_handling.md): Recommended practices for handling state that are emitted from blocs/cubits.

### Testing

- [Testing Best Practices](https://engineering.verygood.ventures/development/testing/testing_best_practices.md): More advanced tips and tricks for writing effective tests.
- [Golden File Testing](https://engineering.verygood.ventures/development/testing/testing_golden_file.md): Golden testing best practices using Alchemist.
- [Testing Overview](https://engineering.verygood.ventures/development/testing/testing_overview.md): VGV's approach to achieving 100% test coverage — why we test, how we organize tests, and what we expect on every project.

### Ui

- [Layouts](https://engineering.verygood.ventures/development/ui/layouts.md): Expanding on rows and columns
- [Routing Overview](https://engineering.verygood.ventures/development/ui/navigation.md): Navigation best practices.
- [Theming](https://engineering.verygood.ventures/development/ui/theming.md): Theming best practices.
- [Widgets](https://engineering.verygood.ventures/development/ui/widgets.md): Widget best practices.

## General practices

- [Our Philosophy](https://engineering.verygood.ventures/general-practices/philosophy.md): Development philosophy at Very Good Ventures.
- [Conventions](https://engineering.verygood.ventures/general-practices/conventions.md): Recommended conventions within software development.
- [Code Reviews](https://engineering.verygood.ventures/general-practices/code_review.md): Code reviews best practices
- [Security in Mobile Apps](https://engineering.verygood.ventures/general-practices/security_in_mobile_apps.md): Mobile app security threats and how to protect your app using OWASP Mobile's 10 best practices.
- [Credits](https://engineering.verygood.ventures/general-practices/credits.md): Very Good Engineering credits and attributions.

## Resources

- [Services](https://engineering.verygood.ventures/resources/services.md): Third party integrations we've used.
- [Airplane Entertainment System](https://engineering.verygood.ventures/resources/airplane_entertainment_system.md): A sample project that simulates an airplane entertainment system.