# Very Good Engineering Documentation Links

## Development

### Architecture

- [Layered Architecture](https://engineering.verygood.ventures/development/architecture/architecture/llms.txt): Architecture best practices.
- [Barrel Files](https://engineering.verygood.ventures/development/architecture/barrel_files/llms.txt): Best practices for exposing public facing files.

### CI/CD

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

### Code style

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

### Documentation

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

### Error handling

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

### Internationalization

- [Localization](https://engineering.verygood.ventures/development/internationalization/localization/llms.txt): Recommended practices to localize software and make it accessible in multiple languages.
- [Text Directionality](https://engineering.verygood.ventures/development/internationalization/text_directionality/llms.txt): 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/llms.txt): Specifying the order in which Bloc events are handled.
- [State Handling](https://engineering.verygood.ventures/development/state_management/bloc_state_handling/llms.txt): Recommended practices for handling state that are emitted from blocs/cubits.

### Testing

- [Testing Best Practices](https://engineering.verygood.ventures/development/testing/testing_best_practices/llms.txt): More advanced tips and tricks for writing effective tests.
- [Golden File Testing](https://engineering.verygood.ventures/development/testing/testing_golden_file/llms.txt): Golden testing best practices using Alchemist.
- [Testing Overview](https://engineering.verygood.ventures/development/testing/testing_overview/llms.txt): 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/llms.txt): Expanding on rows and columns
- [Routing Overview](https://engineering.verygood.ventures/development/ui/navigation/llms.txt): Navigation best practices.
- [Theming](https://engineering.verygood.ventures/development/ui/theming/llms.txt): Theming best practices.
- [Widgets](https://engineering.verygood.ventures/development/ui/widgets/llms.txt): Widget best practices.

## General practices

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

## Resources

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