FireAuth is a Flutter Package that aims to simplify Flutter Firebase Authentication and streamline app development. It provides a intuitive way to access Parts of the Firebase Authentication Suite and reduces the amount of time you have to spend on it. Works for both Flutter Native and Flutter Web!
Add this line to your pubspec.yaml:
dependencies:
fireauth: ^0.9.0
Then run this command:
$ flutter packages get
Then add this import:
import 'package:fireauth/fireauth.dart';
Setting up Firebase correctly to work with all the Authentication Methods provided by FireAuth can sometimes be difficult and tedious! Hence, I have come up with a python script that will do most of the hardwork for you! It also contains well documented instructions so that the entire process is very smooth. It's better than the official documentation!
🔴 If you do not use FireSetup there could be some issues due to incorrect manual setup.
- Android (Full Support)
- Web (Full Support)
- iOS (Full Support)
- macOS ( Dependencies Unsupported )
- Windows ( Dependencies Unsupported )
- Linux ( Dependencies Unsupported )
- Anonymous
- Email & Password Register & SignIn
- Phone
- Github
- Microsoft
- Yahoo
- Apple (Untested)
- Passwordless (Implementation Pending)
⚠️ Most of these Authentication Methods need extra setup! Everything is documented very well in the FireSetup README
☑️ fireauth exports and exposes the firebase_core, firebase_auth and provider packages by default! Hence, you need not import them separately! This ensures you do not clutter your project with multiple imports! You can find the dependency versions here
void main() async {
//This initializes Firebase Accordingly (Important)
await initializeFirebase(); //This method is from the fireauth package
runApp(YourApp());
}
//Allows the Authentication Methods to be accessible from anywhere in the widget tree
return FireAuth(
child: MaterialApp(
home: MyAppHome(),
),
);
//This basically acts like a Gateway, If youre logged in, it shows the destinationFragment
//else it shows the loginFragment (It Remembers the Authentication State too!)
return AuthManager(
loginFragment: LoginPage(),
destinationFragment: HomePage(),
);
The AuthController is a Dart class that contains several static methods that exposes useful functions!
For more information on these methods, take a look at them using the IDE, they are very well documented, but this is all you need for it to work in the default way
🟡 GoogleSignIn Needs Additional Setup
AuthController.signInWithGoogle(
context,
onError: (String e) {},
onSignInSuccessful: (User u) {},
);
AuthController.signInAnonymously(
context,
onSignInSuccessful: (User u) {},
onError: (String e) {},
);
🟡 PhoneSignIn Needs Additional Setup
AuthController.signInWithPhoneNumber(
context,
phoneNumber: phoneNumberController.value.text,
onError: (e) {},
onInvalidVerificationCode: () {},
onSignInSuccessful: (User u) {},
);
};
AuthController.registerWithEmailAndPassword(
context,
email: "example@email.com",
password: "abc123",
onError: (String e) {},
onRegisterSuccessful: (User u) {},
);
AuthController.signInWithEmailAndPassword(
context,
email: "example@email.com",
password: "abc123",
onError: (String e) {},
onIncorrectCredentials: () {},
onSignInSuccessful: (User u) {},
);
🟡 FacebookSignIn Needs Additional Setup
AuthController.signInWithFacebook(
context,
onSignInSuccessful: (User u) {},
onError: (String e) {},
);
🟡 OAuthSignIn Needs Additional Setup
//Twitter OAuth SignIn
AuthController.signInWithTwiter(
context,
onSignInSuccessful: (User u) {},
onError: (String e) {},
);
//Github OAuth SignIn
AuthController.signInWithGithub(
context,
onSignInSuccessful: (User u) {},
onError: (String e) {},
);
//Microsoft OAuth SignIn
AuthController.signInWithMicrosoft(
context,
onSignInSuccessful: (User u) {},
onError: (String e) {},
);
//Yahoo OAuth SignIn
AuthController.signInWithYahoo(
context,
onSignInSuccessful: (User u) {},
onError: (String e) {},
);
//Apple OAuth SignIn (Native on iOS)
AuthController.signInWithApple(
context,
onSignInSuccessful: (User u) {},
onError: (String e) {},
);
AuthController.logout(context);
AuthController.getCurrentUser(
context,
//Optional Arguement, if not provided, It just returns a Firebase User
customMapping: (user) => {
'name': user.displayName,
'email': user.email,
},
);
If you just want a ready to use button that enables a particular Social SignIn, This is these are the Widgets that you're looking for!
import 'package:fireauth/fireauth.dart';
//SocialButtons
TwitterSocialButton(),
GithubSocialButton(),
MicrosoftSocialButton(),
GoogleSocialButton(),
FacebookSocialButton(),
//This Button Uses the new Facebook Design Language
NewFacebookSocialButton(),
YahooSocialButton(),
AnonymousSocialButton(),
AppleSocialButton(),
//MiniSocialButtons
MiniTwitterSocialButton(),
MiniGithubSocialButton(),
MiniMicrosoftSocialButton(),
MiniGoogleSocialButton(),
MiniFacebookSocialButton(),
//This Button Uses the new Facebook Design Language
MiniNewFacebookSocialButton(),
MiniAnonymousSocialButton(),
MiniYahooSocialButton(),
AppleSocialButton(),
/* Each of these buttons accept a SocialButtonConfiguration! Ex:
GoogleSocialButton(
config: SocialButtonConfiguration(
foregroundColor: Colors.black,
backgroundColor: Colors.white,
onSignInSuccessful: (user) {
print("GoogleSignIn Successful!!! UID: ${user.uid}");
},
onError: (e) {
showDialog(
context: context,
builder: (context) => AlertDialog(
title: Text("GoogleOAuth Error Occured"),
content: Text(e),
),
);
},
),
),
More info provided in the Docstring of the SocialButtonConfiguration class
*/
- Move FireAuth to sound null safety
- Declare Production Ready Status