Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update README.md #29

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
78 changes: 75 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Achevio Backend

Welcome to the Achevio Backend repository! This project is designed to serve as the backend service for the Achevio application, handling all the data processing, storage, and API services required to power the front-end experience.
Welcome to the Achevio Backend ReadMe Section! This project is designed to serve as the backend service for the Achevio application, handling all the data processing, storage, and API services required to power the front-end experience.

## Getting Started

Expand Down Expand Up @@ -67,12 +67,84 @@ To get the backend service up and running, you'll need to have Docker installed
Run

```sh
litestar run -rd
litestar run -r -H {YourIpAddress} --port {yourPort}
```

The `-rd` flag is optional, `-r` is for reload, so that the api will automaticall relaunch whenever it detects a change in the sourcefile (great for development while testing!), and the `-d` is for debug, LiteStar will be giving more detailed traceback messages. Both are optional and you can feel free to omit them.

Once the service is up, you can access the API at: `http://127.0.0.1:8000/schema/swagger`
Once the service is up, you can access the API at: `http://{yourIPaddress}:{yourPort}/schema/swagger`

---

# Achevio Frontend

Welcome to the Achevio Frontend ReadMe Section! This section of the project is focused on building a user-friendly interface for interacting with the Achevio application. The frontend is designed to communicate with the backend service to fetch, display, and manipulate data.

## Getting Started

Setting up the frontend development environment requires a few key steps, including installing Node.js, the Expo CLI, and project dependencies.

### Prerequisites

- Node.js
- Expo CLI

### Installation and Setup

1. **Install Node.js**

Download and install Node.js from [the official Node.js website](https://nodejs.org/). This will also install `npm`, which is Node.js' package manager.

2. **Install Expo CLI**

Expo is an open-source platform for making universal native apps for Android, iOS, and the web with JavaScript and React. Install the Expo CLI globally using `npm`:

```sh
npm install -g expo-cli
```

3. **Clone the Repository**

If you haven't already, clone the Achevio repository to your local machine and navigate to the Frontend directory:

```sh
git clone https://github.com/techstartucalgary/Achevio.git
cd Achevio/Frontend
```

4. **Install Dependencies**

Install the necessary project dependencies using `npm`:

```sh
npm install
```

5. **Start the Development Server**

Launch the development server with Expo:

```sh
npm start
```

This command will start the Expo development server and open a web page in your default browser. You can then run the app on an iOS or Android simulator, or on a physical device using the Expo app.

6. **Viewing the App**

After starting the development server, you can view the app by scanning the QR code displayed in the terminal or command prompt with the Expo app (available on Android and iOS) if you're using a physical device. For simulators, follow the instructions in the terminal or the Expo developer tools web interface.

7. **Connecting the Frontend With the Backend**

Go to app/redux/reducers.tsx and add the your IP address in the initial state object ( You can get that ip through running npm start and it will show up in metro line like := Metro waiting on exp://10.0.0.244 )
make sure that the backend server is running on the same IP address.

### Additional Notes

- Ensure your backend service is running, as the frontend will need to communicate with it.
- For detailed documentation on Expo and its features, visit the [Expo documentation](https://docs.expo.dev/).

---

And that's it! you can start developing 🎉!

Expand Down