Skip to content

Latest commit

 

History

History
50 lines (31 loc) · 2.07 KB

CONTRIBUTING.md

File metadata and controls

50 lines (31 loc) · 2.07 KB

Contributing

...is welcome!

Issue tracking / Repository

From issues to wikis: everything is on GitHub

Linting / Formatting

Everything is formatted with dartfmt (no flags) and linted with dartanalyzer (see rules). Both are enforced by the CI.

Translations

Architecture

Lemmur is written in Dart using Flutter. To communicate with Lemmy instances lemmy_api_client is used.

State management

ChangeNotifier + Provider is used for global state management, flutter_hooks is used for local (widget-level) state management. StatefulWidgets are avoided all together and any state logic reuse is moved to a custom hook.

Project structure

(relative to lib/)

  • hooks/: reusable state hooks
  • l10n/: files with localized strings and localizations tools
  • pages/: fullscreen pages that you navigate to
  • stores/: global stores
  • util/: utilities
  • widgets/: reusable widgets; building blocks for pages
  • main.dart: entrypoint of the app. Sets up the stores, initializes the themes, renders the first page

Things to keep in mind

  • Be aware that Lemmur supports arbitrary Lemmy instances, don't hardcode instance urls
  • Remember that a user is not obligated to be logged in, contributed widgets should handle this case

For React developers

If you come from a React background Flutter shouldn't be anything hard to grasp for you.

  • Components are called 'widgets' in flutter
  • flutter_hooks is a React hooks port to flutter. Though you will come to see that flutter_hooks are not as powerful
  • There is no CSS. You compose your layout with other widgets and style them by passing properties to them
  • There are no functional components, everything has to be a class
  • Creating wrapping widgets is not as nice as in React, there is no { ...props }. In flutter you need to pass each argument one by one