https://github.com/broxus/nekoton_webview
https://github.com/broxus/nekoton_webview
Last synced: over 1 year ago
JSON representation
- Host: GitHub
- URL: https://github.com/broxus/nekoton_webview
- Owner: broxus
- License: agpl-3.0
- Created: 2023-05-12T14:37:49.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-10-17T14:54:27.000Z (over 1 year ago)
- Last Synced: 2024-10-19T12:50:26.126Z (over 1 year ago)
- Language: Dart
- Size: 1.65 MB
- Stars: 1
- Watchers: 7
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Nekoton Webview
[![style: very good analysis][very_good_analysis_badge]][very_good_analysis_link]
[![License: AGPLv3][license_badge]][license_link]
[](https://github.com/broxus/nekoton_webview/actions/workflows/main.yaml)
Flutter webview nekoton inpage provider bindings
## Installation 💻
**❗ In order to start using Nekoton Webview you must have the [Flutter SDK][flutter_install_link] installed on your machine.**
Add [nekoton_webview][pubdev_link] to your `pubspec.yaml`:
```yaml
dependencies:
nekoton_webview:
```
## Melos magic 🪄
Using [melos](https://melos.invertase.dev/) makes it very easy to work with the project, so enjoy.
You can run any job interactively run running `melos run` and selecting needed case or directly (e.g. `melos run test`).
### Bootstrap 🏁
Melos takes care about dependencies of all packages, including managing of local-generated library version. So, just run:
```
melos bs
```
### Codegen 🦾
This thing will run all code generators for all packages:
```
$ melos run codegen
```
### Clean up 🧹
Just run commands below to clean all, including build directories and flutter projects.
```
melos clean
```
### Tests ✔️
You can run all tests at one by running this command.
```
melos run test
```
### Code 📊
You can run code analysis:
```
melos run analyze
```
### Code format 🗃️
`melos run check-format` will check, `melos run format` will fix dart code formatting.
```
melos run check-format
melos run format
```
### Prepare to commit 🤝🏻
`melos run check-all` will check, analyze and run all tests.
```
melos run check-all
```
## Conventional Commits ❤️
[This magic](https://melos.invertase.dev/guides/automated-releases#versioning) will update version and build our library automatically using commit messages and tags. [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0) is a lightweight convention on top of commit messages.
## Version 🏷️
Package version control is done by melos. It runs by gh action 'Create version PR' ```melos version -a --yes```.
## Continuous Integration 🤖
Nekoton Webview comes with a built-in [GitHub Actions workflow][github_actions_link] powered by [Very Good Workflows][very_good_workflows_link] but you can also add your preferred CI/CD solution.
Out of the box, on each pull request and push, the CI `formats`, `lints`, and `tests` the code. This ensures the code remains consistent and behaves correctly as you add functionality or make changes. The project uses [Very Good Analysis][very_good_analysis_link] for a strict set of analysis options used by our team. Code coverage is enforced using the [Very Good Workflows][very_good_coverage_link].
## Github Secrets 🔑
`BOT_ACCESS_TOKEN`: Personal access token (PAT) used to fetch the repository. We should use PAT and not default GITHUB_TOKEN because ["When you use the repository's GITHUB_TOKEN to perform tasks, events triggered by the GITHUB_TOKEN, with the exception of workflow_dispatch and repository_dispatch, will not create a new workflow run"](https://docs.github.com/en/actions/using-workflows/triggering-a-workflow#triggering-a-workflow-from-a-workflow). We want to trigger a workflow from the workflow (to run tests), so we need to use PAT. This thing is used in `version` workflow.
[flutter_install_link]: https://docs.flutter.dev/get-started/install
[github_actions_link]: https://docs.github.com/en/actions/learn-github-actions
[license_badge]: https://img.shields.io/badge/license-AGPLv3-blue.svg
[license_link]: https://opensource.org/license/agpl-v3/
[very_good_analysis_badge]: https://img.shields.io/badge/style-very_good_analysis-B22C89.svg
[very_good_analysis_link]: https://pub.dev/packages/very_good_analysis
[very_good_coverage_link]: https://github.com/marketplace/actions/very-good-coverage
[very_good_workflows_link]: https://github.com/VeryGoodOpenSource/very_good_workflows
[pubdev_link]: https://pub.dev/packages/nekoton_webview