Skip to content

Commit

Permalink
Merge pull request #69 from agiledev-students-fall2023/readmes
Browse files Browse the repository at this point in the history
Update README.md for frontend and backend
  • Loading branch information
cindyliang01 authored Nov 12, 2023
2 parents a3e9aa2 + d7c03e1 commit f48bf5d
Show file tree
Hide file tree
Showing 2 changed files with 80 additions and 48 deletions.
48 changes: 48 additions & 0 deletions back-end/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
# Backend Setup for Our Application

Welcome to the backend part of our application, which uses Express.js. This guide provides step-by-step instructions to set up and run the backend on your local machine.

## Prerequisites

Before starting, ensure you have the following installed:

- [Node.js](https://nodejs.org/): Required to run the Express.js server and manage dependencies.
- [npm](https://www.npmjs.com/): Comes bundled with Node.js and is used for package management.

## Getting Started

Follow these steps to get the backend server running:

### Step 1: Clone the Repository

If you haven't already, clone the main repository to your local machine. Use the following command in your terminal:

```bash
git clone https://github.com/agiledev-students-fall2023/4-final-project-group-bill-splitting-app.git
```

Navigate to the backend directory:

```bash
cd back-end
```

### Step 2: Install Dependencies

Install the necessary Node.js packages for the backend:

```bash
npm install
```

### Step 3: Start the Server

Run the following command to start the Express.js server:

```bash
npm start
```

The server will start, typically on `http://localhost:3001`.

Thank you for contributing to our project!
80 changes: 32 additions & 48 deletions front-end/README.md
Original file line number Diff line number Diff line change
@@ -1,70 +1,54 @@
# Getting Started with Create React App
# Getting Started with Our App

This project was bootstrapped with [Create React App](https://github.com/facebook/create-react-app).
Welcome to our application! This guide will walk you through the steps to set up and run the front-end of our app on your local machine.

## Available Scripts
## Prerequisites

In the project directory, you can run:
Before you begin, ensure that you have [Node.js](https://nodejs.org/) installed on your system. This will provide you with the necessary tools like `npm` (Node Package Manager) to install dependencies and run the application.

### `npm start`
## Setting Up the Front-End

Runs the app in the development mode.\
Open [http://localhost:3000](http://localhost:3000) to view it in your browser.
Follow these simple steps to get the front-end up and running:

The page will reload when you make changes.\
You may also see any lint errors in the console.
### Step 1: Clone the Repository

### `npm test`
If you haven't already, clone the main repository to your local machine. Use the following command in your terminal:

Launches the test runner in the interactive watch mode.\
See the section about [running tests](https://facebook.github.io/create-react-app/docs/running-tests) for more information.
```bash
git clone https://github.com/agiledev-students-fall2023/4-final-project-group-bill-splitting-app.git
```

### `npm run build`
Navigate to the front-end directory:

Builds the app for production to the `build` folder.\
It correctly bundles React in production mode and optimizes the build for the best performance.
```bash
cd front-end
```

The build is minified and the filenames include the hashes.\
Your app is ready to be deployed!
### Step 2: Install Dependencies

See the section about [deployment](https://facebook.github.io/create-react-app/docs/deployment) for more information.
Install the required packages using npm. These packages are essential for the app to function correctly:

### `npm run eject`
```bash
npm install
```

**Note: this is a one-way operation. Once you `eject`, you can't go back!**
### Step 3: Start the Application

If you aren't satisfied with the build tool and configuration choices, you can `eject` at any time. This command will remove the single build dependency from your project.
With all the dependencies in place, start the application by running:

Instead, it will copy all the configuration files and the transitive dependencies (webpack, Babel, ESLint, etc) right into your project so you have full control over them. All of the commands except `eject` will still work, but they will point to the copied scripts so you can tweak them. At this point you're on your own.
```bash
npm start
```

You don't have to ever use `eject`. The curated feature set is suitable for small and middle deployments, and you shouldn't feel obligated to use this feature. However we understand that this tool wouldn't be useful if you couldn't customize it when you are ready for it.
### Accessing the App

## Learn More
Once the app is running, it will be available in development mode. Open your web browser and go to [http://localhost:3000](http://localhost:3000) to view the app.

You can learn more in the [Create React App documentation](https://facebook.github.io/create-react-app/docs/getting-started).
- The page will automatically reload if you make any changes to the code.
- Any lint errors will be displayed in the console for easy debugging.

To learn React, check out the [React documentation](https://reactjs.org/).
## Additional Notes

### Code Splitting
- **Backend Integration:** Our app includes a backend component as well. For the application to function fully, please ensure that you also set up the backend. You can find the instructions in the [Backend README](../back-end/README.md).

This section has moved here: [https://facebook.github.io/create-react-app/docs/code-splitting](https://facebook.github.io/create-react-app/docs/code-splitting)

### Analyzing the Bundle Size

This section has moved here: [https://facebook.github.io/create-react-app/docs/analyzing-the-bundle-size](https://facebook.github.io/create-react-app/docs/analyzing-the-bundle-size)

### Making a Progressive Web App

This section has moved here: [https://facebook.github.io/create-react-app/docs/making-a-progressive-web-app](https://facebook.github.io/create-react-app/docs/making-a-progressive-web-app)

### Advanced Configuration

This section has moved here: [https://facebook.github.io/create-react-app/docs/advanced-configuration](https://facebook.github.io/create-react-app/docs/advanced-configuration)

### Deployment

This section has moved here: [https://facebook.github.io/create-react-app/docs/deployment](https://facebook.github.io/create-react-app/docs/deployment)

### `npm run build` fails to minify

This section has moved here: [https://facebook.github.io/create-react-app/docs/troubleshooting#npm-run-build-fails-to-minify](https://facebook.github.io/create-react-app/docs/troubleshooting#npm-run-build-fails-to-minify)
Happy coding!

0 comments on commit f48bf5d

Please sign in to comment.