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

Add a Codacy badge to README.md #47

Open
wants to merge 5 commits into
base: develop
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
35 changes: 16 additions & 19 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,56 +1,53 @@
barebones setup for JavaScript / Node projects replace this with a one-liner phrase describing this project or app

[![Codacy Badge](https://img.shields.io/badge/Code%20Quality-D-red)](https://img.shields.io/badge/Code%20Quality-D-red)


## About

What is this project about. Ok to enrich here or the section above it with an image.
[![Codacy Badge](https://api.codacy.com/project/badge/Grade/348001407d8b4d8b83d1348c5645e34a)](https://app.codacy.com/gh/BuildForSDG/team-011-backend?utm_source=github.com&utm_medium=referral&utm_content=BuildForSDG/team-011-backend&utm_campaign=Badge_Grade_Settings)

Once this repo has been setup on Codacy by the TTL, replace the above badge with the actual one from the Codacy dashboard, and add the code coverage badge as well. This is mandatory
The application is an innovative solution for connecting subsistent farmers to land owners. It offers the farmers the opportunity to rent the lands at affordable prices.

This is a simple JavaScript starter repo template for setting up your project. The setup contains
## See Use Case

- Jest: For runnung tests. We strongly recommend that JavaScript projects use Jest
Below is a use case flow of the application

- Eslint & Prettier: For formatting code to match ESlint AirBnB coding standard. You might need to install the ESlint and Prettier plugins for your code editor to make the most of these utilities
![FarmLord Use Case](docs/use-case.jpg 'FarmLord Use Case')

## Why

Talk about what problem this solves, what SDG(s) and SGD targets it addresses and why these are imoirtant
The solution is necessary because many people who wish to farm do not have information about available lands or the prices. Also, the people who have lands but do not know people who need the lands.

## Usage
How would someone use what you have built, include URLs to the deployed app, service e.t.c when you have it setup

Farmers and Landowners login to the application to carry out necessary tasks.

## Setup

Install `npm` or `yarn` if you dont have any of them already installed. We recommend Yarn though.
Install `yarn install`

After clonning the repo to your local machine and moving into the cloned folder, Run `yarn install` to get started by installing dependencies.
After clonning the repo `git clone https://github.com/BuildForSDG/team-011-backend.git` , cd team-011-backend to your local machine and moving into the cloned folder, Run `yarn install` to get started by installing dependencies.

`src/index.js` is the entry to the project and source code should go into the `src` folder.
`src/server.js` is the entry to the project and source code should go into the `src` folder.

All tests should be written in the `__tests__' folder. There's a sample in there.
All tests should be written in the `**tests**' folder. There's a sample in there.

This starter uses [Parcel](https://parceljs.org/getting_started.html) as the bundler. It is much simpler that WebPack and the others

#### Hints

- Run `npm install` or `yarn install` to get started. We'll assume you are using Yarn.
- Run `yarn install` to get started.
- Install additional dependencies: `yarn add <dependency-name> [-D]`
- Run tests: `yarn test`
- Run tests with test coverage info: `yarn test:cover`
- Check the codebase for proper syntax and formatting compliance: `yarn lint`
- Run your app in local dev mode: `yarn start`. This puts the bundled app in a `dist` folder, set up a local web server at localhost:1234, and continues to watch for your code changes which it syncs with the local server. This means if you loaded the app in a browser, it will auto-refresh as you code along. Feel free to use whatever bundler best meets your needs. Parcel was only added as a sample and for those looking for a simple but effective solution to the hassle of bundlers.
- Run your app in local dev mode: `yarn start`. This puts the bundled app in a `dist` folder, set up a local web server at localhost:1234, and continues to watch for your code changes which it syncs with the local server. This means if you loaded the app in a browser, it will auto-refresh as you code along. Feel free to use whatever bundler best meets your needs. Parcel was only added as a sample and for those looking for a simple but effective solution to the hassle of bundlers.

## Authors

List the team behind this project. Their names linked to their Github, LinkedIn, or Twitter accounts should siffice. Ok to signify the role they play in the project, including the TTL and mentor

## Contributing

If this project sounds interesting to you and you'd like to contribute, thank you!
First, you can send a mail to buildforsdg@andela.com to indicate your interest, why you'd like to support and what forms of support you can bring to the table, but here are areas we think we'd need the most help in this project :

1. area one (e.g this app is about human trafficking and you need feedback on your roadmap and feature list from the private sector / NGOs)
2. area two (e.g you want people to opt-in and try using your staging app at staging.project-name.com and report any bugs via a form)
3. area three (e.g here is the zoom link to our end-of sprint webinar, join and provide feedback as a stakeholder if you can)
Expand All @@ -64,5 +61,5 @@ Did someone’s blog post spark off a wonderful idea or give you a solution to n
It's powerful to always give credit.

## LICENSE
MIT

MIT