contributors

Description:

contributors

Contributors #




Features 🎮 #

🎈 Ready to use UI for showing contributors.
😜 Builder widget for customizing the feel and look of the UI.
🚀 Data is directly from GitHub REST API v3.
🌐 Translations support!

Screenshots #



list of contributors
one contributor info









Usage 👷‍♂️ #
There are three sections for the usage:

Ready UI
Custom UI
Translations

Ready UI #
To use the ready UI you just use the ContributorsView widget and fill the required properties.
Example:
import 'package:flutter/material.dart';
import 'package:contributors/contributors.dart';

class ReadyUI extends StatelessWidget {
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(),
body: ContributorsView(
ownerName: "Flutter-Buddies",
repoName: "contributors",
),
);
}
}
copied to clipboard
Custom UI #
To use the custom UI you just use the ContributorsViewBuilder widget and fill the required properties.
Example:
import 'package:flutter/material.dart';
import 'package:contributors/contributors.dart';

class CustomUI extends StatelessWidget {
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(),
body: ContributorsBuilderView(
ownerName: "Flutter-Buddies",
repoName: "contributors",
builder: (
BuildContext context,
List<Contributor> contributors,
) {
return ListView.builder(
itemCount: contributors.length,
itemBuilder: (
BuildContext context,
int index,
) {
final Contributor contributor = contributors[index];

return Text(contributor.login);
},
);
},
),
);
}
}
copied to clipboard
Translations #
Our way of handling localization works with every app. You just need to provide the Locale to the locale property on the widget you are using from Contributors.
Currently we support:

English (en)
Arabic (ar)
Czech (cs)

You can add more languages by specifying the translations property on the widget you use, examples below.

Note that using translations requires you to add every language you want to use, even the factory methods of ContributorsTranslation.

Example (Ready UI):
import 'package:flutter/material.dart';
import 'package:contributors/contributors.dart';

class ReadyUI extends StatelessWidget {
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(),
body: ContributorsView(
ownerName: "Flutter-Buddies",
repoName: "tic-tac-no",
locale: Locale("en"), // try this for english language
// locale: Locale("ar"), // try this for arabic language
translations: <ContributorsTranslation>[
ContributorsTranslation.en(),
ContributorsTranslation.ar(),
ContributorsTranslation.cs(),
ContributorsTranslation(
languageCode: 'es',
contributions: 'Contribuciones',
followers: 'Seguidores',
following: 'Siguiendo',
publicRepos: 'Reposiciones Públicas',
publicGists: 'Gists Públicos',
oopsSomethingWentWrong: '¡UPS! ¡Algo salió mal!',
isRTL: false,
),
],
),
);
}
}
copied to clipboard
Example (Custom UI):
import 'package:flutter/material.dart';
import 'package:contributors/contributors.dart';

class CustomUI extends StatelessWidget {
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(),
body: ContributorsBuilderView(
ownerName: "Flutter-Buddies",
repoName: "contributors",
locale: Locale("en"), // try this for english language
// locale: Locale("ar"), // try this for arabic language
translations: <ContributorsTranslation>[
ContributorsTranslation.en(),
ContributorsTranslation.ar(),
ContributorsTranslation.cs(),
ContributorsTranslation(
languageCode: 'es',
contributions: 'Contribuciones',
followers: 'Seguidores',
following: 'Siguiendo',
publicRepos: 'Reposiciones Públicas',
publicGists: 'Gists Públicos',
oopsSomethingWentWrong: '¡UPS! ¡Algo salió mal!',
isRTL: false,
),
],
builder: (
BuildContext context,
List<Contributor> contributors,
) {
return ListView.builder(
itemCount: contributors.length,
itemBuilder: (
BuildContext context,
int index,
) {
final Contributor contributor = contributors[index];

return Text(contributor.login);
},
);
},
),
);
}
}
copied to clipboard