Skip to content

Commit caeb228

Browse files
committed
docs: add README.md
1 parent c086598 commit caeb228

File tree

1 file changed

+114
-0
lines changed

1 file changed

+114
-0
lines changed

README.md

Lines changed: 114 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,114 @@
1+
<p align="center">
2+
<h1 align="center">SafeAlert 🚨</h1>
3+
</a>
4+
</p>
5+
6+
<p align="center">
7+
<img src="https://i.ibb.co/3kRpTnt/image-10.jpg" alt="ava" border="0" width="300px">
8+
</p>
9+
<!-- Here is app icon placeholder -->
10+
11+
> SafeAlert - A mobile app designed to deliver prompt assistance from volunteers nearby, providing effective solutions for unexpected incidents.
12+
13+
This project will join [GDSC Solution Challenge 2024](https://developers.google.com/community/gdsc-solution-challenge).
14+
15+
## Technology used ✨
16+
17+
- [Flutter & Dart](https://flutter.dev/)
18+
- [Google Map Platform](https://mapsplatform.google.com/)
19+
- [Firebase](https://firebase.google.com/)
20+
- [NodeJs](https://nodejs.org/en)
21+
22+
</details>
23+
24+
## Setup and run
25+
26+
<details>
27+
<summary>Click to expand</summary>
28+
<br>
29+
<h3>Clone the repo</h3>
30+
31+
```sh
32+
git clone https://github.com/dscdut/safe-alert
33+
```
34+
35+
<h3>Backend</h3>
36+
37+
1. Prerequisites
38+
39+
- Install node
40+
<https://nodejs.org/en/download/>
41+
42+
- Install yarn
43+
44+
```sh
45+
npm install --global yarn
46+
```
47+
48+
2. Install NPM packages
49+
50+
```sh
51+
cd backend
52+
# run database migrations and seeds
53+
npm run db:reset
54+
yarn install
55+
```
56+
57+
3. Run the development server:
58+
59+
```bash
60+
yarn start
61+
```
62+
63+
4. Open [http://localhost:3000](http://localhost:3000).
64+
65+
<h3>Mobile</h3>
66+
67+
1. Change directory:
68+
69+
```bash
70+
cd ..
71+
cd mobile
72+
```
73+
74+
2. Get the dependencies:
75+
76+
```bash
77+
flutter pub get
78+
```
79+
80+
3. Start build APK release file:
81+
82+
```bash
83+
flutter build apk --release -t lib/main_staging.dart --flavor=staging
84+
```
85+
86+
<!-- - Download APK
87+
- [APK - arm64](https://drive.google.com/file/d/1r5BxLCoTn2JqQuEjAtoUxmZeSHIByEKa/view?usp=sharing)
88+
- Setup and run
89+
- Flutter
90+
- Install [Flutter](https://flutter.dev/docs/get-started/install).
91+
- Using **`stable`** channel:
92+
```bash
93+
❯ flutter channel stable
94+
❯ flutter upgrade
95+
```
96+
- Flutter doctor:
97+
```bash
98+
❯ flutter doctor
99+
```
100+
- Install all the packages by:
101+
```bash
102+
❯ flutter pub get
103+
```
104+
- Create .env file `assets/.env` has following structure:
105+
```bash
106+
BASE_URL=https://api.smartfood.cooking/api
107+
```
108+
- Run app on real devices or emulator by:
109+
```bash
110+
❯ flutter run
111+
```
112+
or debug mode in VSCode or some IDEs -->
113+
114+
</details>

0 commit comments

Comments
 (0)