This project is deprecated, see the tutorial linked below.
Home Page: https://docs.atsign.com/tutorials/flutter-and-atsdk-app
License: BSD 3-Clause "New" or "Revised" License
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
Is your feature request related to a problem? Please describe.
One major problem when starting this project is that there were no packages that allowed you to use your own templates.
Describe the solution you'd like
I'd like to introduce a stripped down library version of at_app for other developers to build upon.
They can specify their own templates, sort of as a "build your own at_app" package.
Describe alternatives you've considered
Not doing it... but that doesn't solve the problem for other devs following in my footsteps.
Additional context
Low priority but something I would like to eventually get to.
All the content shown on pub.dev and where it comes from.
Example: Shelf (will point to one of our own once completed)
Document how to upgrade from one version to another version of at_app within a project
Package name, version <pubspec.yaml>
Published date (generated)
Platform support (generated based on project structure)
Tabbed navigation
Right column
Is your feature request related to a problem? Please describe.
Can't specify a specific version.
Describe the solution you'd like
Use the same format as pub get.
Either don't specify to get latest, or do specify for that specific version.
Describe alternatives you've considered
N/A
Additional context
N/A
Update all at_app_flutter to use at_onboarding_flutter ^4.0.0 and test the templates.
Describe the bug
When creating and @ app from a demo template it is expected that the app should just run without any editing of the files created. However when the app is run it fails with an error in AtEnv.load()
To Reproduce
Steps to reproduce the behavior:
Expected behavior
A clear and concise description of what you expected to happen.
Screenshots
Smartphone (please complete the following information):
Smartphone (please complete the following information):
PS S:\TEMP\test4> flutter --version
Flutter 2.8.1 • channel stable • https://github.com/flutter/flutter.git
Framework • revision 77d935af4d (5 hours ago) • 2021-12-16 08:37:33 -0800
Engine • revision 890a5fca2e
Tools • Dart 2.15.1
PS S:\TEMP\test4>
Is your feature request related to a problem? Please describe.
We don't have an environment capable of doing flutter tests post onboarding.
Describe the solution you'd like
Create an environment that can pump a widget with an onboarded atSign.
Shorthand namespace -n doesn't work (but --namespace does)
at_app CLIat_app create at_onboarding_demo -n=@beaverarmadillo => doesn't workat_app create at_onboarding_demo --namespace=@beaverarmadillo => worksExpected behavior
Is your feature request related to a problem? Please describe.
N/A
Describe the solution you'd like
Add the cookbook template as a demo app.
Describe alternatives you've considered
N/A
Additional context
N/A
Is your feature request related to a problem? Please describe.
Some installations of flutter have an altered pub cache location, and yet the PUB_CACHE environment variable is unset on the system.
I've opened an issue on Homebrew
Describe the solution you'd like
at_app should be able to get the correct pub_cache location.
OR
It should not require the pub_cache to install the templates.
Describe alternatives you've considered
Additional context
I think the pub_cache location has been proven to be unreliable, so hosting the templates elsewhere may be a better solution.
Is your feature request related to a problem? Please describe.
permission_handler package requires compileSDKVersion 31 for android.
Describe the solution you'd like
Have this happen automatically for the developer when at_app create is run.
Describe alternatives you've considered
A clear and concise description of any alternative solutions or features you've considered.
Additional context
Add any other context or screenshots about the feature request here.
Describe the bug
The at_app command fails when i run it in the console using the version 4.1.0
at_app is active
josueerazo@MacBook-Air-de-Josue ~ % fvm flutter pub global activate at_app
Package at_app is currently active at version 4.1.0.
Resolving dependencies...
The package at_app is already activated at newest available version.
To recompile executables, first run `flutter pub global deactivate at_app`.
Installed executable at_app.
Activated at_app 4.1.0.
Run Logs
josueerazo@MacBook-Air-de-Josue ~ % at_app
Can't load Kernel binary: Invalid kernel binary format version.
Precompiling executable... (1.3s)
Failed to precompile at_app:at_app:
.pub-cache/hosted/pub.dartlang.org/source_span-1.8.2/lib/source_span.dart:1:1: Error: The specified language version is too high. The highest supported language version is 2.12.
// Copyright (c) 2014, the Dart project authors. Please see the AUTHORS file
^
.pub-cache/hosted/pub.dartlang.org/source_span-1.8.2/lib/src/file.dart:1:1: Error: The specified language version is too high. The highest supported language version is 2.12.
// Copyright (c) 2014, the Dart project authors. Please see the AUTHORS file
^
.pub-cache/hosted/pub.dartlang.org/source_span-1.8.2/lib/src/location.dart:1:1: Error: The specified language version is too high. The highest supported language version is 2.12.
// Copyright (c) 2014, the Dart project authors. Please see the AUTHORS file
^
.pub-cache/hosted/pub.dartlang.org/source_span-1.8.2/lib/src/location_mixin.dart:1:1: Error: The specified language version is too high. The highest supported language version is 2.12.
// Copyright (c) 2015, the Dart project authors. Please see the AUTHORS file
^
.pub-cache/hosted/pub.dartlang.org/source_span-1.8.2/lib/src/span.dart:1:1: Error: The specified language version is too high. The highest supported language version is 2.12.
// Copyright (c) 2014, the Dart project authors. Please see the AUTHORS file
^
.pub-cache/hosted/pub.dartlang.org/source_span-1.8.2/lib/src/span_exception.dart:1:1: Error: The specified language version is too high. The highest supported language version is 2.12.
// Copyright (c) 2014, the Dart project authors. Please see the AUTHORS file
^
.pub-cache/hosted/pub.dartlang.org/source_span-1.8.2/lib/src/span_mixin.dart:1:1: Error: The specified language version is too high. The highest supported language version is 2.12.
// Copyright (c) 2014, the Dart project authors. Please see the AUTHORS file
^
.pub-cache/hosted/pub.dartlang.org/source_span-1.8.2/lib/src/span_with_context.dart:1:1: Error: The specified language version is too high. The highest supported language version is 2.12.
// Copyright (c) 2014, the Dart project authors. Please see the AUTHORS file
^
.pub-cache/hosted/pub.dartlang.org/source_span-1.8.2/lib/src/charcode.dart:1:1: Error: The specified language version is too high. The highest supported language version is 2.12.
// Copyright (c) 2020, the Dart project authors. Please see the AUTHORS file
^
.pub-cache/hosted/pub.dartlang.org/source_span-1.8.2/lib/src/highlighter.dart:1:1: Error: The specified language version is too high. The highest supported language version is 2.12.
// Copyright (c) 2018, the Dart project authors. Please see the AUTHORS file
^
Flutter doctor
josueerazo@MacBook-Air-de-Josue ~ % fvm flutter doctor -v
[✓] Flutter (Channel stable, 2.8.1, on macOS 12.0.1 21A559 darwin-arm, locale en-EC)
• Flutter version 2.8.1 at /Users/josueerazo/fvm/versions/stable
• Upstream repository https://github.com/flutter/flutter.git
• Framework revision 77d935af4d (5 weeks ago), 2021-12-16 08:37:33 -0800
• Engine revision 890a5fca2e
• Dart version 2.15.1
[✓] Android toolchain - develop for Android devices (Android SDK version 30.0.3)
• Android SDK at /Users/josueerazo/Library/Android/sdk
• Platform android-30, build-tools 30.0.3
• ANDROID_HOME = /Users/josueerazo/Library/Android/sdk
• Java binary at: /Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java
• Java version OpenJDK Runtime Environment (build 11.0.8+10-b944.6916264)
• All Android licenses accepted.
[✓] Xcode - develop for iOS and macOS (Xcode 13.0)
• Xcode at /Applications/Xcode.app/Contents/Developer
• CocoaPods version 1.11.2
[✓] Chrome - develop for the web
• Chrome at /Applications/Google Chrome.app/Contents/MacOS/Google Chrome
[✓] Android Studio (version 4.2)
• Android Studio at /Applications/Android Studio.app/Contents
• Flutter plugin can be installed from:
🔨 https://plugins.jetbrains.com/plugin/9212-flutter
• Dart plugin can be installed from:
🔨 https://plugins.jetbrains.com/plugin/6351-dart
• Java version OpenJDK Runtime Environment (build 11.0.8+10-b944.6916264)
[✓] VS Code (version 1.63.2)
• VS Code at /Applications/Visual Studio Code.app/Contents
• Flutter extension version 3.32.0
• No issues found!
As previously discussed, our support for ios will be N-2 and thus at_app templates will be set to n-2 (currently 13) by default.
Lead: @XavierChanth
Describe the bug
I've been getting consistent "bug reports" for at_app after developers update their flutter installation.
Depending on the method used to install flutter, sometimes pub global binaries do not play nice.
The most common issue is when flutter gets updated and changes the pub global bin location.
Flutter will install the binaries to the new location, and then try to run it from the old location.
There are other less common ways, that also present the same symptoms and can be resolved in the same way.
When trying to run at_app, the user will be presented with one of the following messages:
"No active package at_app."
Warning: Executable "at_app" runs "bin/at_app.dart", which was not found in at_app.
flutter pub global run at_app:at_app internally, then pub drops the ballExpected behavior
Users can refer to the solution steps instead of requiring my direct aid.
Screenshots
Additional context
The issue is OS agnostic, have had reports on both Windows and macos.
Never had this issue when installing Flutter SDK using git, if you are reading this, please install using git :)
Describe the bug
Unable to test demo template pops an error
To Reproduce
Steps to reproduce the behavior:
PS C:\Users\colin\GitHub\@foundation\at_app> dart run at_app/bin/at_app.dart create -d snackbar --local s:\TEMP\test
Creating project in s:\TEMP\test
Project created, now adding a little @ magic...
[!] ERROR: An unknown issue occurred:
Bad state: No element
Please file a ticket to prevent this from happening again:
https://github.com/atsign-foundation/at_app
PS C:\Users\colin\GitHub\@foundation\at_app
Expected behavior
Template to create runabable app from template
Screenshots
See above
Smartphone (please complete the following information):
PS C:\Users\colin\GitHub\@foundation\at_app> flutter --version
Flutter 2.8.0-3.2.pre • channel beta • https://github.com/flutter/flutter.git
Framework • revision 2901cd7208 (4 weeks ago) • 2021-11-18 11:15:09 -0800
Engine • revision bcc2b7f12c
Tools • Dart 2.15.0 (build 2.15.0-268.18.beta)
PS C:\Users\colin\GitHub\@foundation\at_app>
Additional context
If you need to I can create a branch so you can see my attempt of creating the templates as this could well be me!
Lead: @XavierChanth
Currently using a basic string to write the generated files in at_app.
Would like to eventually publish this package for other devs to use with at_template, probably under another name.
Is your feature request related to a problem? Please describe.
Easy to start an app, why not make it easy to learn/start using a package.
Describe the solution you'd like
Each option will be mutually exclusive, you can only use one per app generated.
at_app would also need to support adding additional dependencies to the project, based on what sample/demo app is being generated.
Some additional work for file management may need to be done to add support for modifying app permissions, etc.
Describe alternatives you've considered
Rather than samples, create templates for each type... but what if you want multiple samples...
An approach to multiple samples could be use one base template and the power of regex to dynamically generate a sample app.
Additional context
Updated 11/25/2021 in response to recent discussions on improving the developer experience.
Is your feature request related to a problem? Please describe.
flutter_config doesn't support desktop apps.
Describe the solution you'd like
Replace with an alternative that does.
Describe alternatives you've considered
dotenv_flutter.
Additional context
N/A
Is your feature request related to a problem? Please describe.
at_app is relatively slow, because it essentially does generation twice.
Once for flutter, then once for at_app.
Describe the solution you'd like
Use mason to build the app templates.
Describe alternatives you've considered
None so far.
I want to do a POC to see if this helps us with automation in any way, my guess is yes since we can build the mason bricks outside of at_app_templates, and use their git path instead.
Additional context
This could potentially simplify the pipeline from package examples -> at_app samples.
Is your feature request related to a problem? Please describe.
The .env file will contain the api-key for production applications and should be ignored by default.
Describe the solution you'd like
Add ".env" to .gitignore file.
Describe alternatives you've considered
Not ignoring the file, however it's better to be secure by default.
Additional context
Add any other context or screenshots about the feature request here.
Is your feature request related to a problem? Please describe.
Developer activation through at_app.
Describe the solution you'd like
Describe alternatives you've considered
N/A
Additional context
N/A
Is your feature request related to a problem? Please describe.
If you aren't familiar with the commands for at_app, it can still be confusing on how to use it.
Describe the solution you'd like
An extension for vscode that serves as an abstraction of at_app, providing an easy to use interface for @platform developers.
Describe alternatives you've considered
N/A
Additional context
A good example is melos and the code extension for it.
Describe the bug
When creating and @ app from a demo template it is expected that the app should just run without any editing of the files created. However one of the dependences @ apps have is https://pub.dev/packages/biometric_storage which needs a few files edited before it will run on android.
Make sure to use the latest kotlin version:
android/build.gradle: ext.kotlin_version = '1.4.31'
To Reproduce
Steps to reproduce the behavior:
dart run at_app/bin/at_app.dart create -d snackbar --local s:\TEMP\test5flutter run which will fail due to the kotlin version issueExpected behavior
flutter run to work and run the app without any need of editing other files
Screenshots
If applicable, add screenshots to help explain your problem.
Smartphone (please complete the following information):
PS S:\TEMP\test4> flutter --version
Flutter 2.8.1 • channel stable • https://github.com/flutter/flutter.git
Framework • revision 77d935af4d (5 hours ago) • 2021-12-16 08:37:33 -0800
Engine • revision 890a5fca2e
Tools • Dart 2.15.1
PS S:\TEMP\test4>
A status badge shows whether a workflow is currently failing or passing. In addition to this, it is important to show our Github BSD 3-clause License badge on all public repositories.
A common place to add the status and license badge is in the README.md at the top alongside the GitHub License.
+ 
+ [](./LICENSE)With discussions about the at_app and mason packages between myself and VGV, I've been asked to raise a proposal solution for multi-template generator support. This is essentially a more abstract, generalized version of the recent work I've been doing with at_app.
Is your feature request related to a problem? Please describe.
This should be the single source of truth for the demo version of chit_chat.
Describe the solution you'd like
Add the chit_chat template as a demo application.
Describe alternatives you've considered
N/A
Additional context
N/A
Is your feature request related to a problem? Please describe.
The whole of at_app create will run (and fail) if pub add at_app_flutter fails.
Describe the solution you'd like
It should retry the pub add if it fails once, and it should throw a tool exit if it fails twice.
Describe alternatives you've considered
Additional context
Describe the bug
When I create or recreate (at_app create .)a project using CLI I get this output stating that
'pub' is not recognized as an internal or external command,
operable program, or batch file.
at the end of the result. But it doesn't happen with flutter create ..
To Reproduce
Steps to reproduce the behavior:
Expected behavior
The expected behavior is not to get any error output if we don't get it while creating or recreating a flutter project with the flutter command.
Screenshots
Output for flutter create .
Output for at_app create .
Smartphone (please complete the following information):
Were you using an @application when the bug was found?
Additional Context
Is your feature request related to a problem? Please describe.
This application is way too slow
Describe the solution you'd like
Make it faster!
Describe alternatives you've considered
N/A
Additional context
Performance test results..
Is your feature request related to a problem? Please describe.
N/A
Describe the solution you'd like
Be able to generate the demo app using at_app create -d snackbar <path>
Describe alternatives you've considered
N/A
Additional context
N/A
Describe the solution you'd like
No longer necessary:
Is your feature request related to a problem? Please describe.
Need a better way of updating at_app app configurations... no easy way to do it currently.
#42 may be the answer, since mason innately supports the overwrite technique.
Describe the solution you'd like
Add a config command to take care of individual configuration.
Describe alternatives you've considered
N/A
Additional context
This may be deprecated by at_template.
Describe the solution you'd like
Per the guidance from dart-lang/lints:
in pubspec.yaml:
- pedantic: ^1.11.0
+ lints: ^1.0.1and in each analysis_options.yaml:
-include: package:pedantic/analysis_options.yaml
+include: package:lints/recommended.yamlDescribe the bug
Over the weekend we had some people using at_app to create their apps, however they were not able to get the api key working. After investigation I noticed that the issue was with the dotenv package, so it needs to be replaced with flutter_config.
Is your feature request related to a problem? Please describe.
If there is an existing app that wants to use at_app template they have to start rewriting from the scratch. That will take lots of time and patience.
Describe the solution you'd like
At_app will have a command for existing app that doesn't use at_platform. With that command they will create a new file and all the configuration file. It should be different from flutter create as it will only create the configuration file and onboarding.
Describe alternatives you've considered
A clear and concise description of any alternative solutions or features you've considered.
Additional context
Useful for quickly switch from non-atplatform app to platform app.
Is your feature request related to a problem? Please describe.
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
Describe the solution you'd like
at_client is version locked to 2.x.x, needs to be updated to 3.x.x.
Describe alternatives you've considered
Additional context
Describe the bug
at_app_flutter throws an instance of FileNotFoundException.
To Reproduce
Steps to reproduce the behavior:
Expected behavior
It should warn the user instead of crashing the app.
Screenshots
Smartphone (please complete the following information):
N/A
at_app_flutter 3.0.0
Were you using an @application when the bug was found?
N/A
Additional context
Will be fixed in the next release of at_app_flutter.
Is your feature request related to a problem? Please describe.
The new model for generating templates has broken the --overwrite flag, it is essentially being ignored.
Describe the solution you'd like
Find a smart way to reenable this flag before next release.
Describe alternatives you've considered
N/A
Additional context
N/A
Lead: @XavierChanth
There are many points of failure that could cause at_app to fail when generating the app.
There is also a lot of code to cover within at_app, the template bundlers, template generators, and generated templates all need to be covered eventually. As we add more samples to at_app, this will quickly become harder to maintain.
My goal is to increase test coverage to handle as much of this as possible.
Preparation Work
Unit/Integration Tests - Focus for PR 35
Functional Tests
I was thinking of how fast a newbie can start developing for at_platform. So for now dev can not do production development right away with at_app which holds them to onboard with their free atsign and test their at_platform based codes. To get an api key takes time as it is done by mail. So I was thinking of API key generator would be great to reduce the time of getting api key.
Maybe we can discuss it in architecture call.
The args -h logger is white, so changing info logger to white for consistency.
All the content shown on pub.dev and where it comes from.
Example: Shelf (will point to one of our own once completed)
Package name, version <pubspec.yaml>
Published date (generated)
Platform support (generated based on project structure)
Tabbed navigation
Right column
Is your feature request related to a problem? Please describe.
The current gitignore from at_template/base does not allow you to specify additional files to be gitignored.
Describe the solution you'd like
Pass a var of type list to the internal mason bundle for base, and add the same var to the wrapper models.
Describe alternatives you've considered
N/A
Additional context
Is your feature request related to a problem? Please describe.
Confusion between this project (at_app_cli) and at_cli
Describe the solution you'd like
I'd like to rename the repository to at_app based on our previous discussions, and I am seeking approval to do so.
The only other place to rename the repository is in the readme.md file's title.
Describe alternatives you've considered
Other names, at_skeleton, at_builder.
Additional context
I prefer the name at_app for the project, since it is more generic, it will make more sense long term if other commands are added to the project.
Is your feature request related to a problem? Please describe.
Describe the solution you'd like
Describe alternatives you've considered
Rather than pulling at_app templates from the pub cache, pull them from a host.
Additional context
Is your feature request related to a problem? Please describe.
Describe the solution you'd like
Describe alternatives you've considered
Additional context
Is your feature request related to a problem? Please describe.
Right now, the template bricks are not setup as individual dart/flutter projects which makes analysis and dependency maintenance challenging.
Describe the solution you'd like
Describe alternatives you've considered
N/A
Additional context
N/A
See atsign-foundation/at_widgets#270 for more information.
Packages:
Is your feature request related to a problem? Please describe.
Based on some of the feedback I've received on my talk at Flutter SV, I'd like to pursue the "open source Flutter templates" angle more.
Describe the solution you'd like
Create an open source cli like at_app but for general Flutter templates.
This would help us increase awareness about at_app_create, and increase the likelihood of developers to contributing or providing feedback.
Describe alternatives you've considered
N/A
Additional context
N/A
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
Django
The Web framework for perfectionists with deadlines.
Laravel
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
Microsoft
Open source projects and samples from Microsoft.
Google
Google ❤️ Open Source for everyone.
Alibaba
Alibaba Open Source for everyone
D3
Data-Driven Documents codes.
Tencent
China tencent open source team.