Skip to content

Commit

Permalink
refactor: updated the read me
Browse files Browse the repository at this point in the history
  • Loading branch information
emilio-kariuki committed Sep 8, 2023
1 parent 5de01d4 commit cfa33d6
Showing 1 changed file with 112 additions and 0 deletions.
112 changes: 112 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,110 @@ authorLink: 'https://github.com/serverless'
authorName: 'Serverless, inc.'
authorAvatar: 'https://avatars1.githubusercontent.com/u/13742415?s=200&v=4'
-->
# GDSC DeKUT
GDSC DeKUT is a community based mobile application built on the flutter framework to help unite the tech Community in `Dedan Kimathi University` by helping the get access to upcoming events, resources, news, tech groups, and the leads contacts to allow them to contact them incase of any challenge in their learning process.
> The app is built courtesy of [GDSC (Google Developer Students Club)](https://gdsc.community.dev/dedan-kimathi-university-of-technology/)
> **Note**
> The app is not built only for GDSC but the whole tech community or anybody that feels they need to get access to resources to help them learn new and cool things
**The app is on PlayStore**

You can find the application here

*[![Play Store Badge](https://developer.android.com/images/brand/en_app_rgb_wo_60.png)](https://play.google.com/store/apps/details?id=com.gdsc.gdsc_app&hl=en&gl=US)*

[![Buy Me a Coffee](https://img.shields.io/badge/buy%20me%20a%20coffee-donate-orange.svg)](https://www.buymeacoffee.com/emiliokariuki)



## Technologies Used in the project
> The mobile application is completely built on the the `flutter` framework and `firebase` platform
1. Flutter
2. Firebase

. Cloud Messaging

. Firebase Storage

. Firebase Firestore

. Authentication

## Project Set up
### 1. Initialize firebase
To initialize firebase we are going to use `FlutterFire` for this work as it will do all the dirty work for us

You can check more about `flutterfire` from its [docs](https://firebase.flutter.dev/docs/cli/)

> **Note**
> Yoo need to have a Firebase account, incase you dont have you can create one [here](https://firebase.google.com/)
After you have fully installed `flutterfire` you can now enable flutterfire for your project now

### 2. Enable FlutterFire for your Flutter Project
To get started, you need to run the following command in the terminal of your ide of your project's directory
```
// paste in your terminal
dart pub global activate flutterfire_cli
```
## 3. Login to Firebase from your account
> **Note**
> To get started, you need to install this you need to have [npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm/)(node package manager installed) for you to install the `firebase tools`
```
// paste this
firebase login
```
## 4. Configure Flutterfire to your project
The FlutterFire CLI extracts information from your Firebase project and selected project applications to generate all the configuration for a specific platform.

In the root of your `application`, run the configure command:

```
// paste this
flutterfire configure
```

After you install, all the configurations in your `build.gradle` file are added and the `google-service.json` are added in the android folder and `Firebase` will be integrated in your system this will save you all the trouble of having to install all the configurations one by one and this may cause some of the things to be oeverlooked.

### 5. Home Page
The `home page` tries to feature all the sub sections of the application from the events announcements, groups, twitter and even the profile page.
<div style="display: flex;">
<img src="gdsc-dekut-mobile/Assets/home_page1.png" alt="Event" width= 300 height= 600>
<img src="gdsc-dekut-mobile/Assets/home_page2.png" alt="Event" width= 300 height= 600>
</div>



### 6. Event Page
All the events that are upcoming in the tech community can be found in the `event page`


<div style="display: flex;">
<img src="gdsc-dekut-mobile/Assets/event_page.png" alt="Event" width= 300 height= 600>
<img src="gdsc-dekut-mobile/Assets/event_dialog.png" alt="Event" width= 300 height= 600>
</div>

### 7. Resources Page
All the resources that the members of the tech community will be found `here`

In the `resources` page the members are given the ability to post new reources if they have any to share with the other members

<div style="display: flex;">
<img src="gdsc-dekut-mobile/Assets/resource_page.png" alt="Event" width= 300 height= 600>
<img src="gdsc-dekut-mobile/Assets/resource_dialog.png" alt="Event" width= 300 height= 600>
</div>

### 8. Groups Page
All the tech groups in the community will be found `here`

In the `news` page the members are given the ability to get acess to the groups in the tech comunity and also the newly posted news in Community

<div style="display: flex;">
<img src="gdsc-dekut-mobile/Assets/group_page.png" alt="Event" width= 300 height= 600>
<img src="gdsc-dekut-mobile/Assets/group_dialog.png" alt="Event" width= 300 height= 600>
</div>



# Serverless Framework AWS NodeJS Example
Expand Down Expand Up @@ -70,3 +174,11 @@ Which should result in response similar to the following:
"body": "{\n \"message\": \"Go Serverless v3.0! Your function executed successfully!\",\n \"input\": \"\"\n}"
}
```

### Feel Free to contribute
You can `fork` the repo and feel free to contribute

> **Note**
> You can reach me up on email `[email protected]` or twitter `@EG_Kariuki`

0 comments on commit cfa33d6

Please sign in to comment.