{"id":15353227,"url":"https://github.com/yardexx/freerasp_brick","last_synced_at":"2025-06-28T21:35:50.424Z","repository":{"id":65081555,"uuid":"551671210","full_name":"yardexx/freerasp_brick","owner":"yardexx","description":"A brick for configuration generation and automatic setup for freeRASP.","archived":false,"fork":false,"pushed_at":"2024-10-20T20:09:18.000Z","size":84,"stargazers_count":9,"open_issues_count":2,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-15T05:52:51.759Z","etag":null,"topics":["bricks","cli","code-generation","dart","flutter","freerasp","mason","template"],"latest_commit_sha":null,"homepage":"","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yardexx.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-10-14T21:25:36.000Z","updated_at":"2024-07-30T02:16:49.000Z","dependencies_parsed_at":"2023-02-18T08:45:33.489Z","dependency_job_id":null,"html_url":"https://github.com/yardexx/freerasp_brick","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yardexx%2Ffreerasp_brick","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yardexx%2Ffreerasp_brick/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yardexx%2Ffreerasp_brick/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yardexx%2Ffreerasp_brick/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yardexx","download_url":"https://codeload.github.com/yardexx/freerasp_brick/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249016318,"owners_count":21198832,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bricks","cli","code-generation","dart","flutter","freerasp","mason","template"],"created_at":"2024-10-01T12:13:28.715Z","updated_at":"2025-04-15T05:52:57.120Z","avatar_url":"https://github.com/yardexx.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# freeRASP brick\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://github.com/felangel/mason\"\u003e\u003cimg src=\"https://img.shields.io/endpoint?url=https%3A%2F%2Ftinyurl.com%2Fmason-badge\" alt=\"Powered by Mason\"\u003e\u003c/a\u003e\n\u003ca href=\"https://pub.dev/packages/freerasp\"\u003e\u003cimg src=\"https://img.shields.io/badge/Supported%20freeRASP-%5E3.0.0-brightgreen\" alt=\"Supported freeRASP\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/yardexx/freerasp_brick/actions/workflows/brick_workflow.yml\"\u003e\u003cimg src=\"https://github.com/yardexx/freerasp_brick/actions/workflows/brick_workflow.yml/badge.svg\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://codecov.io/gh/yardexx/freerasp_brick\"\u003e\u003cimg src=\"https://codecov.io/gh/yardexx/freerasp_brick/branch/master/graph/badge.svg?token=300N5C20OB\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://pub.dev/packages/very_good_analysis\"\u003e\u003cimg src=\"https://img.shields.io/badge/style-very_good_analysis-B22C89.svg\" alt=\"style: very good analysis\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opensource.org/licenses/MIT\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-MIT-purple.svg\" alt=\"License: MIT\"\u003e\u003c/a\u003e\n\u003c/p\u003e \n\n\u003cp align=\"center\"\u003e\nA brick for \u003ca href=\"https://pub.dev/packages/freerasp\"\u003efreeRASP\u003c/a\u003e to generate configuration code \nand automate necessary setup.\n\u003c/p\u003e\n\n\u003e 🚧 This brick is experimental and not stable! Changes to API/file generation reserved.\n\n## Overview\nSetting up freeRASP can be quite tedious and repetitive. freerasp_brick provides you error-proof \nway to create configuration.\n\n## Features 🧰\n- 🛠 Configuration generation\n- 🎯 Dependency check using `pub get`\n- 🔧 Fix apply using `dart fix`\n- 🤖 Android SDK level check and automatic update\n- 🍎 iOS script insertion in Runner.xcscheme (Experimental)\n\n## How to add ➕\n\n### Using BrickHub.dev\nYou can add freerasp_brick to your project just like any other brick:\n```shell\nmason add freerasp_brick\n```\n\n### Using GitHub dependency\nYou can also add freerasp_brick to your project using `--git-url` option:\n```shell\nmason add --git-url https://github.com/yardexx/freerasp_brick freerasp_brick\n```\n\n\u003e 💡 If you plan to use freeRASP in many different projects, it's useful to have freerasp_brick as global brick. You can do it by adding `--global` option.\n\n## How to use 🚀\n\nYou can generate freeRASP configuration by running:\n```shell\nmason make freerasp_brick\n```\n\nAfter providing necessary information, freerasp_brick will generate following file structure:\n```\nfreerasp\n├── freerasp.g.dart\n└── freerasp_callback.g.dart\n```\n\nThen simply import `freerasp.g.dart` in your desired file and use it:\n```dart\nimport 'freerasp/freerasp.g.dart';\n\n// Some other code...\n\ntalsec.start();\n```\n\n## Generated reactions 💣\n\nDefault generated reaction for every callback is `print` to console.\n\nIf you wish to change it, you can do so by editing `freerasp_callback.g.dart` file.\n\n## Variables 📦\n| Variable      | Description                   | Default         | Type   | Conditional | When            |\n|---------------|-------------------------------|-----------------|--------|-------------|-----------------|\n| watcher_mail  | An email for security reports | N/A             | String | false       | N/A             |\n| android       | Add Android configuration     | true            | bool   | false       | N/A             |\n| package_name  | Android app package name      | com.example.app | String | true        | android == true |\n| signing_hash  | Android app signing hash      | N/A             | String | true        | android == true |\n| update_gradle | Update build.gradle file      | true            | bool   | true        | android == true |\n| ios           | Add iOS configuration         | true            | bool   | false       | N/A             |\n| bundle_id     | iOS app id                    | com.example.app | String | true        | ios == true     |\n| team_id       | iOS team id                   | N/A             | String | true        | ios == true     |\n| update_scheme | Update Runner.xcscheme file   | true            | bool   | true        | ios == true     |\n\n\u003e ⚠ Since freerasp_brick is heavily dependent on hooks, using `-c` option won't skip prompts generated by hooks.\n\n## Hooks 🎣\n| Type     | Enabled | Can be disabled |\n|----------|---------|-----------------|\n| pre-gen  | ✅       | ❌               |\n| post-gen | ✅       | ❌               |\n\n\u003e ⚠ Brick won't generate files correctly if you disable `pre-gen` or `post-gen` hook.\n\n## Contribution 🤝\nFor issues, bugs, or feature proposals feel free to [open issue](https://github.com/yardexx/freerasp_brick/issues) \nor [create PR](https://github.com/yardexx/freerasp_brick/pulls). \n\n## Useful resources 📚\nIf this is your first touch with freeRASP or Mason, you refer to these resources to get started:\n\n### Getting started with [freeRASP][freerasp-pubdev] 🛡\n- [freeRASP on GitHub][freerasp-github]\n- [freeRASP website][freerasp-website]\n- [Medium article: freeRASP — In-App protection SDK and app security monitoring service][freerasp-medium]\n\n### Getting started with [mason][mason-github]  🧱\n- [Mason on GitHub][mason-github]\n- [Official Mason Documentation][mason-docs]\n- [Code generation with Mason Blog][mason-blog]\n- [Very Good Livestream: Felix Angelov Demos Mason][mason-yt]\n\n[mason-github]: https://github.com/felangel/mason\n\n[mason-docs]: https://github.com/felangel/mason/tree/master/packages/mason_cli#readme\n\n[mason-blog]: https://verygood.ventures/blog/code-generation-with-mason\n\n[mason-yt]: https://youtu.be/G4PTjA6tpTU\n\n[freerasp-github]: https://github.com/talsec/Free-RASP-Flutter\n\n[freerasp-pubdev]: https://pub.dev/packages/freerasp\n\n[freerasp-website]: https://www.talsec.app/freerasp-in-app-protection-security-talsec\n\n[freerasp-medium]: https://medium.com/geekculture/freerasp-in-app-protection-sdk-and-app-security-monitoring-service-de12d8e49400\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyardexx%2Ffreerasp_brick","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyardexx%2Ffreerasp_brick","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyardexx%2Ffreerasp_brick/lists"}