SoftServe Car

Platform for sharing rides between company employees

---

Table of Contents (Optional)

• Installation
  • Required to install

  • Environment

  • Clone
  • How to run locally
  • How to run with Docker
• Usage
  • How to work with swagger UI
  • How to run tests
  • How to Checkstyle
• Documentation)
• Contributing
  • git flow
  • issue flow

• FAQ

• Support
• License

---

Installation

Required to install

• IOS 12.0 or higher
• Android 5.0 or higher

Clone

• Clone this repo to your local machine using $ git clone https://github.com/ita-social-projects/SoftServeCar-Back-End.git

How to run locally

To run app locally you should proceed these instructions https://reactnative.dev/docs/environment-setup with such options: 1. Selected guide: React Native CLI Quikcstart 2. Development OS: Windows 3. Target OS: Android You can switch beetwen options depending on your OS.

Possible issue: 1. VT-x can be turn off (Solution - https://www.youtube.com/watch?v=MOuTxfzCvMY) 2. "npx react-native run-android" can be replaced by "npm run android" 3. If you get an error "emulator didn`t start within 30 seconds" try to run firstly emulator via AVD manager (Android Studio) and then your app.
4. Before running app first time, install all dependencies by "npm i"

How to run with Docker

---

Usage

How to work with swagger UI

How to run tests

How to Checkstyle

---

Documentation

---

Contributing

You're encouraged to contribute to our project if you've found any issues or missing functionality that you would want to see. Here you can see the list of issues and here you can create a new issue.

Before sending any pull request, please discuss requirements/changes to be implemented using an existing issue or by creating a new one. All pull requests should be done into dev branch.

Though there are two GitHub projects: SoftServeCar-Back-End for back-end part and SoftServeCar-Front-End for front-end part) all of the requirements are listed in the first one - SoftServeCar-Back-End.

Every pull request should be linked to an issue. So if you make changes on front-end part you should create an issue there (subtask) with a link to corresponding requirement (story, task or epic) on back-end.

All Pull Requests should start from prefix #xxx-yyy where xxx - task number and and yyy - short description e.g. #020-CreateAdminPanel Pull request should not contain any files that is not required by task.

Git flow

To get started...

Step 1

• Option 1

  • 🍴 Fork this repo!

• Option 2

  • 👯 Clone this repo to your local machine using https://github.com/ita-social-projects/SOMEREPO.git

Step 2

• HACK AWAY! 🔨🔨🔨

Step 3

• 🔃 Create a new pull request using github.com/ita-social-projects/SOMEREPO.

Issue flow

---

Team

Or Contributors/People

• You can just grab their GitHub profile image URL
• You should probably resize their picture using ?s=200 at the end of the image URL.

---

FAQ

• How do I do specifically so and so?
  • No problem! Just do this.

---

Support

Reach out to me at one of the following places!

• Facebook at Nataliya Revutska
• LinkedIn at Nataliya Revutska
• Insert more social links here.

---

License

• MIT license
• Copyright 2020 © SoftServe IT Academy.