joshuadeguzman / shorebird Goto Github PK

Home of the Shorebird Tools

We're in the process of converting the quick demos written by one person, into a multi-contributor project usable by others. Previous demo code can be found at: https://github.com/shorebirdtech/old_repo

Refer to shorebird/install for installation instructions.

This repository is a monorepo containing the following packages:

For more information, please refer to the documentation for each package.

❗️ Note: This project is under heavy development. Things will change frequently and none of the code is ready for production use. We will do our best to keep the documentation up-to-date.

If you're interested in contributing, please join us on Discord.

Working on Shorebird requires Dart and Rust.

We currently assume the Dart from the Flutter SDK on the 'stable' channel. Due to the way the Dart compiler works, Shorebird requires an exact version of Flutter/Dart to operate correctly today.

We currently assume Rust 1.67.0 or later, although the code is unlikely to be sensitive to the exact version of Rust.

Once both are installed, ./scripts/bootstrap.sh will run pub get and cargo check for all packages in the repository.

We don't yet have a script to run tests locally. For now, you can run tests manually by running cargo test in a Rust package directory or dart test in a Dart package directory.

Shorebird projects are licensed for use under either Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0) MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT) at your option.

See our license philosophy for more information on why we license files this way: https://github.com/shorebirdtech/handbook/blob/main/engineering.md#licensing-philosophy