Skip to content

Commit dd09316

Browse files
authored
Merge pull request #67 from CMP26Projects/update-readme
🔥 rewrite and modification for the readme / rebranding to ` Kashafty`
2 parents aa52679 + 67dd200 commit dd09316

1 file changed

Lines changed: 47 additions & 17 deletions

File tree

README.md

Lines changed: 47 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,40 @@
1-
# Scout Management System
1+
# ![Logo](READMEImages/logo-ex.png) Kashafty
22

3-
![Logo](READMEImages/logo-ex.png)
3+
This is Kashafty! An SPA for managing all the scout groups needs. Attendance, finance, activities you name it! we got it! 😉
44

5-
## About the Project
5+
<!-- Scout management system is a website implemented using **PERN stack**. This project is a 2nd year CUFE project for practicing on the fundamental rules of database system management. -->
66

7-
Scout management system is a website implemented using **PERN stack**. This project is a 2nd year CUFE project for practicing on the fundemental rules of database system management.
7+
<!-- TODO: replace with an image that have Kashafty on it or maybe a GIF -->
88

9-
![Landing Page](READMEImages/Landing%20Page%20Cropped.png)
9+
## 🤔 But why?
10+
11+
- Have you ever tried to record the attendance of over 500 person using only a paper and a pen? Well, we did and it was a mess!
12+
- Have you ever had to make reports on something and found yourself in the face of a huge pile of papers that is impossible to handle? guess what, we did too!
13+
- as a leader, have you ever found yourself in a headache trying to manage the mess of data and reports that come from every direction with no clear structure? we totally understand you!
14+
15+
So we made `Kashafty` the solution for all scout groups' problems. It is a website that helps you manage all your scouts' data, activities, finance and much more!
16+
17+
<!-- ## Our website is now on air🔥 -->
1018

11-
## Our website is now on air🔥
19+
<!-- We deployed our website, although, it is still in progress so you might find some missing functionalities. -->
1220

13-
We deployed our website, although, it is still in progress so you might find some missing functoinalities.
21+
<!-- To login as a general captain use: -->
1422

15-
To login as a general captain use:
23+
<!-- > email: general@gmail.com -->
24+
<!-- > pass: 1234 -->
1625

17-
> email: general@gmail.com
18-
> pass: 1234
26+
## 🚀 Quick start
1927

20-
🔥[Website Link](https://scouts-managment-system-development.onrender.com/)🔥
28+
To get started navigate to [Kashafty demo](https://scouts-managment-system-development.onrender.com/) and use this account to try out the Main functionalities:
29+
30+
> - email:[general@gmail.com](general@gmail.com)
31+
> - pass: 1234
32+
33+
you can also create your own account and try out the system as a regular captain.
34+
35+
![Landing Page](READMEImages/Landing%20Page%20Cropped.png)
2136

22-
## Why do you have to use this website?
37+
## 📖 Documentation and features
2338

2439
This website is based on a well structured database and a user friendly app, which helps in providing the best managerial experience to the scout captains. It helps them in:
2540

@@ -52,6 +67,16 @@ This website is based on a well structured database and a user friendly app, whi
5267
- Providing graphs for better analysis
5368
- Getting reports on the current system status
5469

70+
## 🧰 Tech Stack
71+
72+
- **Frontend**
73+
74+
<img src="https://img.icons8.com/color/48/000000/react-native.png"/> <img src="https://img.icons8.com/color/48/000000/redux.png"/> <img src="https://img.icons8.com/color/48/000000/javascript.png"/> <img src="https://img.icons8.com/color/48/000000/sass.png"/> <img src="https://img.icons8.com/color/48/000000/figma.png">
75+
76+
- **Backend**
77+
78+
<img src="https://img.icons8.com/color/48/000000/nodejs.png"/> <img src="https://img.icons8.com/color/48/000000/express-js.png"/> <img src="https://img.icons8.com/color/48/000000/postgreesql.png"/>
79+
5580
## Pre-implementation phase
5681

5782
### Database design
@@ -74,17 +99,22 @@ We have designed a complete UX design for all system pages: about 40 pages
7499

75100
[User Stories](https://drive.google.com/file/d/1RwYU0OpM7EVVqLCTXDNxmlU7WgaKOdvz/view?usp=sharing)
76101

77-
## How to run?
102+
## How to run locally?
78103

79-
run the following commands in the terminal
104+
after filling the `.env` file as required. run the following commands in the terminal
80105

81-
```
106+
```bash
82107
npm i
83108
npm run dev
84109
```
85110

86-
## Contributers
111+
## Contributors
87112

88-
| ![Abdelruhman](https://avatars.githubusercontent.com/u/121282837?v=4) | ![Amir](https://avatars.githubusercontent.com/u/88613195?v=4) | ![Akram](https://avatars.githubusercontent.com/u/109467185?v=4) | ![Ahmed](https://avatars.githubusercontent.com/u/104217693?v=4) |
113+
<!-- | ![Abdelruhman](https://avatars.githubusercontent.com/u/121282837?v=4) | ![Amir](https://avatars.githubusercontent.com/u/88613195?v=4) | ![Akram](https://avatars.githubusercontent.com/u/109467185?v=4) | ![Ahmed](https://avatars.githubusercontent.com/u/104217693?v=4) |
89114
| --------------------------------------------------------------------- | ------------------------------------------------------------- | --------------------------------------------------------------- | --------------------------------------------------------------- |
90115
| [AbdelruhmanSamy](https://github.com/AbdelruhmanSamy/) | [amir-kedis](https://github.com/amir-kedis/) | [akramhany](https://github.com/akramhany/) | [AhmedHamed3699](https://github.com/AhmedHamed3699) |
116+
-->
117+
118+
| <img src="https://avatars.githubusercontent.com/u/121282837?v=4" width="100px" alt="Abdelruhman"> | <img src="https://avatars.githubusercontent.com/u/88613195?v=4" width="100px" alt="Amir"> | <img src="https://avatars.githubusercontent.com/u/109467185?v=4" width="100px" alt="Akram"> | <img src="https://avatars.githubusercontent.com/u/104217693?v=4" width="100px" alt="Ahmed"> |
119+
| ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
120+
| [AbdelruhmanSamy](https://github.com/AbdelruhmanSamy/) | [amir-kedis](https://github.com/amir-kedis/) | [akramhany](https://github.com/akramhany/) | [AhmedHamed3699](https://github.com/AhmedHamed3699) |

0 commit comments

Comments
 (0)