Cyrus-Kiprop/afriTrend

A web app where users can display African based styles and trending staff

AFRITREND LIFESTYLE WEB APP

A web App created in the fulfillment of Microverse mandatory Ruby on Rails capstone project.
View Demo · Report Bug · Request Feature

Table of Contents

• About the Project
  • Live Demo
  • Built With
• Getting Started
  • Prerequisites
  • Installation
• Usage
• Roadmap
• Contributing
• License
• Contact
• Acknowledgements

About The Project

There are numerous lifestyle websites available on the internet today. This apps helps us plan our daily routine with ease and consume content at the comfort of our houses. I scoured the internet with aim to find lifestyle app that is well tailord based on a specific region, especially africa, however, I coul'nt find one that provided personal content based on regions. I have created and afriTrend inorder to address this shortcoming.

AfriTrend is aimed at providing the following content:

Nutrition

• Balanced nutrition content, which is based on africa native delicacies.
• ability to explore and compare different types of diets.
• Help in simplifying diets, by creating personalized diet based on native african recipes.

Fitness

• Articles related to fitness are added to the database. This provide a large pool of resources.
• One can acquire the composition of products throught the producrs.
• Articles constituting of multilevel training session for home based exercises.

Fashion

• Disover latest clothing trends from fashion's top designer in Africa

Live Demo

Click here for a live demo of the app.

Built With

The project was built using the following languages stacks:

Back-End(server)

• Ruby -v 2.7.1
• Ruby on Rails -v 5.2+

Front-End(client)

• Bootstrap v 4
• ERB
• Sass
• Font Awesome Icons

Testing Frameworks

• Capybara
• RSpec

Getting Started

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

Prerequisites

• Ruby -v 2.7.1 -click here

• Rails -v 5.2.4

gem install rails -v 5.2.4

• Postgresql database click here

Installation

1. Clone the repo

git clone https://github.com/Cyrus-Kiprop/afriTrend.git

2. CD into the project root directory

cd ./afriTrend

3. Install Dependencies and gems

bundle install

4. Set the databases

rails db:create

5. Create database schemas

rails db:migrate

Usage

Fire up the server:

rails s

Navigate to your browser and open port 3000:

http//localhost:3000

Create an Admin User

Sign In

Create Categories (Admin Only)

Create a new article

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/NewAwesomeFeature)
3. Commit your Changes (git commit -m 'Add some NewAmazingFeature')
4. Push to the Branch (git push origin feature/NewAmazingFeature)
5. Open a Pull Request

Contact

Cyrus Kiprop - cyruskiprop254@gmail.com

Project Link: https://github.com/Cyrus-Kiprop/afriTrend

Authors

👤 Cyrus Kiprop

• Github: Cyrus-Kiprop
• Twitter: @kipropJS
• Linkedin: Cyrus Kiprop

Acknowledgements

• Heroku
• Font Awesome
• Best-README-Template
• PNG-SVG converter

License

Distributed under the MIT License. See LICENSE for more information.