Apply GitHub’s languages colours into Flutter’s Color
object.
Receiving ozh’s github-colors repository with latest commit of colors.json
to Flutter’s Color
object.
Usage
You can either initalized GitHubColour
before runApp(Widget)
(Call it after WidgetsFlutterBinding.ensureInitialized()
if want to get data from offline):
// With offline last resort
void main() async {
WidgetsFlutterBinding.ensureInitialized();
await GitHubColour.getInstance();
runApp(const YourApp());
}
// Without offline last resort
void main() async {
await GitHubColour.getInstance(offlineLastResort: false);
runApp(const YourApp());
}
then uses getExistedInstance()
inside the Widget
:
class YourAppWidget extends StatelessWidget {
@override
Widget build(BuildContext context) => Scaffold(
appBar: AppBar(
backgroundColor: GitHubColour.getExistedInstance().find("Go")
)
);
}
or wrapped into FutureBuilder
with initalized Future<GitHubColour>
variable from State
‘s initState
(not recommended uses getInstance()
directly in FutureBuilder
):
class _YourAnotherAppWidgetState extends State<YourAnotherAppWidget> {
late final Future<GitHubColour> _ghc;
@override
void initState() {
super.initState();
_ghc = GitHubColour.getInstance();
}
@override
Widget build(BuildContext context) => FutureBuilder<GitHubColour>(
future: _ghc,
builder: (context, snapshot) {
// Implement whatever you want
}
);
}
Cache for connection failed
This package supported caching system as a backup when making request failed. It uses LZMA compress data and store as a file under temporary directory (for VM)
or store as shared_preference
(for Web, which is LocalStorage
).
If no cache available, by default, GitHubColour.getInstance()
will uses local’s colors.json
as last resort. However, this package will not synchronized when newer commit of color.json
pushed since it minified that ensure the package can be downloaded as fast as possible.
Note for American English developers
It’s provide alias class GitHubColor
for who uses “color” mostly.
Screenshots
License
BSD-3