Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/kidd254/hello_rails_back_end

Last synced: 27 days ago
JSON representation

Host: GitHub
URL: https://github.com/kidd254/hello_rails_back_end
Owner: Kidd254
License: mit
Created: 2023-11-01T11:04:20.000Z (about 1 year ago)
Default Branch: dev
Last Pushed: 2023-11-04T15:03:19.000Z (about 1 year ago)
Last Synced: 2023-11-04T16:22:10.109Z (about 1 year ago)
Language: Ruby
Size: 35.2 KB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        



  Hello Rails Backend



# 📗 Table of Contents

- [📗 Table of Contents](#-table-of-contents)

- [Hello API ](#hello-api-)

  - [🛠 Built With ](#-built-with-)

    - [Tech Stack ](#tech-stack-)

    - [Key Features ](#key-features-)

    - [Frontend Project  ](#frontend-project--)

  - [💻 Getting Started ](#-getting-started-)

    - [Prerequisites](#prerequisites)

    - [Setup](#setup)

    - [Install](#install)

    - [Usage](#usage)

    - [Run linters](#run-linters)

  - [👥 Authors ](#-authors-)

  - [🔭 Future Features ](#-future-features-)

  - [🤝 Contributing ](#-contributing-)

  - [⭐️ Show your support ](#️-show-your-support-)

  - [🙏 Acknowledgments ](#-acknowledgments-)

  - [📝 License ](#-license-)

---

# Hello Rails Backend 

**"Hello Rails Backend"** is a simple API for displaying a random greeting, made with Ruby on Rails and Postgresql.

---

## 🛠 Built With 

### Tech Stack 

  Backend

  


    Ruby on Rails (v7.0.8)

    PostgreSQL

  


### Key Features 



  Ruby on Rails framework

  

    Use Linters to check code quality

    

      Rubocop

    

  

  MVC architectural/design pattern

  Data persistent in PostgreSQL

  RESTful API



(back to top)


---

### Frontend Project  

The frontend project for this API can be found in the following link: [Hello React Frontend](https://github.com/Kidd254/Hello_react_front_end)

(back to top)


---

## 💻 Getting Started 

To get a local copy up and running, follow these steps.

### Prerequisites

In order to run this project you need:



    A code editor (we recommend Visual Studio Code)





    Git and a GitHub account



### Setup

Clone this repository to your desired folder by using this 👇️ command :

```

git clone https://github.com/Kidd254/Hello_Rails_Back_End.git

```

### Install

Go to the project directory:

```

 cd hello_rails_back_end

```

Before to run the program, verify that you have Ruby on Rails installed on your OS running the following command:

```

 rails --version

```

It should show you the version of ruby on rails installed. If this does not happen and only an error message is displayed, then you should either verify your installation or install Ruby on Rails from scratch.

[Download and Install Ruby on Rails](https://guides.rubyonrails.org/getting_started.html)

Once you have verified that you have Ruby on Rails installed, run the following command to install the necessary gems:

```

 bundle install

```

After installing the gems, run the following command to create the database:

```

 rails db:create

```

Then run the following command to migrate the database:

```

 rails db:migrate

```

### Usage

Run the following command inside the project folder to start the application:

```

  rails s

```

Those commands will start the application on your local server. You can now open your browser and go to http://localhost:3000/ to see the application running.

### Run linters

To verify that the ruby code is written without errors and meets good practice standards, run the following command inside the project folder:

- **ruby linter:**

```

 rubocop

```

(back to top)


---

## 👥 Authors 

👤 **Lawrence Muema Kioko**

- GitHub: [@githubhandle](https://github.com/Kidd254)

- Twitter: [@twitterhandle](https://twitter.com/lawrenc98789206)

- LinkedIn: [LinkedIn](https://www.linkedin.com/in/lawrence-muema-kioko)

(back to top)


---

## 🔭 Future Features 

Upcoming improvements:

- [ ] Add the endpoints to create, update and delete a greeting

- [ ] Deploy the application

(back to top)


---

## 🤝 Contributing 

Contributions, issues, and feature requests are welcome!

Feel free to check the [issues page](https://github.com/Kidd254/Hello_Rails_Back_End/issues).

(back to top)


---

## ⭐️ Show your support 

If you like this project and know someone who might find it helpful, please share it.

Or give it a **star** ⭐️ if you like this project!

(back to top)


---

## 🙏 Acknowledgments 

I thank Microverse for this fantastic opportunity, and the code reviewers for their advice and time.

(back to top)


---

## 📝 License 

This project is [MIT](./LICENSE) licensed.

(back to top)


---