Giter VIP home page Giter VIP logo

favours-io / favours Goto Github PK

View Code? Open in Web Editor NEW
16.0 3.0 3.0 716 KB

πŸ—ΊπŸ€ Django back-end & web-app for Favours. A local marketplace for small-jobs, where users can commit to a posted favour in exchange for cash.

Home Page: https://www.favours.xyz

License: MIT License

Python 33.27% HTML 54.46% CSS 11.31% Dockerfile 0.96%
django webapp python django-application django-project commerce local location-based rest-api

favours's Introduction

Logo

Gitter chat MIT License

Logo

About

A local marketplace where users post small-jobs (favours) in exchange for cash; currently in beta. Favours-io plays out in the domain of collaborative consumption. Need a favour? Or want to make some quick cash committing to a favour? The application aims at bringing local communities together by leveraging local connections you have through existing social networks. Open-source and free.

Components

This back-end codebase is found on on a Linode Linux server with SSH and firewalls (UFW) enabled. Running an Apache http server from Django's WSGI, and serving our static files on AWS S3. Kudos to LetsEncrypt for free SSL! The goal is to then leverage Django's built-in REST API to be consumed by Flutter for native mobile application.

Getting Started

Prerequisites

  • Python 3.7+
  • Pip (package manager)

Installing

  1. Fork and clone repo to local system

  2. Create local virtual environment inside project directory, and activate.

    python -m venv env
    
    source env/bin/activate  # Linux/Mac
    env/Scripts/activate  # Windows
  3. Install dependencies

    pip install -r requirements.txt
  4. Add new .env file, at project level.

    Set DEBUG=True in dev. stage, and USE_S3=False to use local static files (.css, .js). Else, you will require AWS IAM credentials

    DEBUG=<True or False>
    SECRET_KEY=<place-secret-key>
    AWS_STORAGE_BUCKET_NAME=favours-bucket
    USE_S3=False
  5. Ready to go! Now run Django

    Note: running the Django server without the --settings=...dev arg will use static files from S3 bucket

    python manage.py runserver --settings=favours.settings.dev

Discussion

Discuss Favours-io in the open Gitter chat. Propose new ideas, or disuss any already existing features. All constructive conversation is welcomed!

License

@ MIT License

favours's People

Contributors

brian-ps avatar brianruizy avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

favours's Issues

Feature request: specific listing/favour page

Describe the solution you'd like
create page for listings/favours

Including:

  • title
  • date posted
  • user who posted, with profile link
  • price
  • written description
  • a "buy" button

more suggestions...

Feature request: simple messaging system

Describe the solution you'd like
Implement a bare-bones messaging system.
One should only be able to message those who have available listings/favours.

include :

  • the listing one is inquiring about, + link

more suggestions...

Feature: Display all listings

Describe the solution you'd like
Listings should be globally visible whether user logged in or not at the homepage.
Include some pagination, site would need to be location aware. To provide the end-user with favours nearby

Feature request: Redesign user profile page

Current design is really simple

image

Can use inspiration for the design from this dribbble

image

Posts from a specific user is already implanted, so it can be shown in a user's profile page as a horizontally scrollable carousel.

Feature Request: Create user profiles

Describe the solution you'd like
Really simple profile pages for all users, viewable in url by favours.com/username

include:

  • up loadable image
  • if account is verified, bool
  • rating, int
  • location, str
  • date joined

more suggestions...

Feature request: user-account page

Describe the solution you'd like
An account page for the logged in specific logged-in user with various functionalities and user settings.

  • view / edit / delete listings
  • login settings
  • notification settings
  • invite friends from socials, button

more suggestions...

Example:

image

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    πŸ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. πŸ“ŠπŸ“ˆπŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❀️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.