From 0bbfbf740d49ff449358c21b453e3fbf2728c03d Mon Sep 17 00:00:00 2001 From: ats527 Date: Sat, 24 Feb 2024 21:22:25 +0530 Subject: [PATCH] update readme --- README.md | 104 ++++++++++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 94 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 18af830..51ffe91 100644 --- a/README.md +++ b/README.md @@ -1,16 +1,100 @@ -# placement_notifier +
-A new Flutter project. +logo -## Getting Started +

Placeme By CEAL

+

High Priority Placement Notifications

-This project is a starting point for a Flutter application. +Get it on Google Play -A few resources to get you started if this is your first Flutter project: -- [Lab: Write your first Flutter app](https://docs.flutter.dev/get-started/codelab) -- [Cookbook: Useful Flutter samples](https://docs.flutter.dev/cookbook) +

· Documentation · Report Bug · Request Feature

-For help getting started with Flutter development, view the -[online documentation](https://docs.flutter.dev/), which offers tutorials, -samples, guidance on mobile development, and a full API reference. +### Don't forget to :star: the repo + +
+
+
+ +# :notebook_with_decorative_cover: Table of Contents + +- [About the Project](#star2-about-the-project) +- [Roadmap](#compass-roadmap) +- [Contributing](#wave-contributing) +- [FAQ](#grey_question-faq) + + +## :star2: About the Project + +### :camera: Screenshots +image +image +image +image +image + + +
Server
+ +### :dart: Features +- Send high priority push notifications +- Saving all the placement calls for future reference +- Ability to edit and add new placement calls + + +## :toolbox: Getting Started + +### :bangbang: Prerequisites + +- Install flutter and Node.js in your system +- Create an account in firebase and turn on authentication with google,firestorage, and firestore database + + +### :running: Run Locally + +Clone the project + +```bash +https://github.com/ATS527/ceal-placement-notifer +``` +Install all the dependencies +```bash +flutter pub get +``` +Create a .env file in project root directory + +```bash +SERVER_URL="your-custom-server-url" +API_KEY="your-custom-api-key" +``` +SERVER_URL is the url of server in which firebase-admin sdk is present, +API_KEY is to avoid unauthorised api calls + + +### :triangular_flag_on_post: Deployment + +To get the optimised build run +```bash +flutter build appbundle +``` + + +## :compass: Roadmap + +* [ ] Create user profile +* [ ] User preferences for notifications + + +## :wave: Contributing + + + +Contributions are always welcome! + +## :grey_question: FAQ + +- Does the application works out of the box? +- No, you need to setup firebase first, then configure node.js server with firebase-admin sdk and run a notification server to really test the application. \ No newline at end of file