Skip to content

The open source Vue.js frontend (mobile and cordova app) for the argentinian carpooling application: Carpoolear

License

Notifications You must be signed in to change notification settings

facuabdo/carpoolear

 
 

Repository files navigation

Carpoolear frontend

Español

Carpoolear es la primera aplicación argentina de Facebook que permite a los usuarios de dicha red social compartir viajes en automóvil con otros usuarios de su entorno.

Es una customización ad-hoc para Argentina de la filosofía carpooling, la cual consiste en compartir nuestros viajes en auto con otras personas de forma cotidiana. El carpooling es una práctica popular en Estados Unidos y Europa, donde se realiza de manera organizada para lograr aumentar el número de viajes compartidos y que estos sean concretados con otras personas además de nuestros vecinos y amigos.

English

Carpoolear is the first Argentine Facebook app that allow the users of this social network share car trips with other users.

It is and ad-hoc customization for Argentina with carpooling philosophy, with consist of sharing our car trips with other people. The carpooling is a popular practice in USA and Europe, where it is practice in a organized way with the purpose of increase the number of trips shared with new people in addition to our neighbors and friends.

Start coding

# git clone
git clone https://github.com/STS-Rosario/carpoolear.git

# install dependencies
npm install

# serve with hot reload at localhost:8080
npm run dev
npm run prod (NOT WORKING)

# serve with hot realod and with prod.env
npm run prod

Selecting project

# selec project, if not project selected, the default project is "default"
# linux and osx
TARGET_APP=myProject

# window poweshell
$env:TARGET_APP = "myProject"

Mobile apps

# in root folder
npm run build:android
npm run build:ios
npm run build-dev:android
npm run build-dev:ios

# the apk will be created in the dist folder

Creating new projects

This branch is multi project. You can handle multiple apps in only one source code. To create a new project, first select it's name, for example "YOUR-PROJECT-NAME".

  1. Then have to go to ./projects folder and clone default folder. Change the name of the folder to "YOUR-PROJECT-NAME" and customize all the assets (google-services.js, config.xml and images). Remember that in config.xml in "cordova-plugin-facebook4" you must put your APP_ID and your APP_NAME of facebook.

  2. If you wanna customize some css files or any vue module like main.css, you must copy the file in the same folder and name it "main.YOUR-PROJECT-NAME.css". When compiling the project webpack will resolve the correct file.

  3. Finally in ./config folder clone the files dev.env.js and prod.env.js and save as dev.YOUR-PROJECT-NAME.env.js and prod.YOUR-PROJECT-NAME.env.js. Personalize the files with your values. Your new project is ready.

Happy coding!

Config

In the config table in your carpoolear DB you can configure the following parameters:

Property Type Description
admin_email STRING Email of the admin.
name_app STRING Name of the app.
target_app STRING Only in development. (target project name)
osm_country STRING Country locale for Open Street Map.
country_name STRING Your country name.
locale STRING Country locale.
home_redirection STRING Your home website url.
module_validated_drivers BOOLEAN If enabled, drivers must be valdiated.
trip_card_design STRING 'default' or 'light' // 'default is the custom carpoolear theme. 'light' is an optional carpoolear theme. You can make your own themes.
trip_stars BOOLEAN If enabled, the punctuation of users is shown as stars, if not as numbers.
max_cards_per_row INT How many trip cards must be shown per row. Default: 4
disable_user_hints BOOLEAN If enabled, user hints are hidden.
login_custom_header BOOLEAN If enabled, you can use a custom header.
enable_footer BOOLEAN If enabled, you can login by facebook.
donation JSON With donation you can configure donation campaigns. Object must be: {"ammount_needed": 1000, "month_days": 0, "trips_count": 20, "trips_offset": 0, "trips_rated": 2}
module_trip_seats_payment BOOLEAN If enabled, online payment if required to travel.
module_user_request_limited JSON Object must be: {"enabled": true, "hours_range": 8}
api_crice BOOLEAN If enabled, active the api that calculate the trip price.
fuel_price FLOAT The local fuel price, to stimate the trip price.
enable_facebook BOOLEAN If enabled, you can login with facebook.
module_on_boarding_new_user JSON Object must be: {"enabled": true, "cards": 4}
allow_rating_reply BOOLEAN If enabled, you can reply a comment of another user
module_coordinate_by_message BOOLEAN If enabled, the trip coordination is in the chat view
module_references BOOLEAN If enabled, references can be made in another user profile

Important

You must respect this linting configuration: /jshint esversion: 6/

All the variable and methods name must be in english.

License

The Carpoolear frontend is open-sourced software licensed under the GPL 3.0.

About

The open source Vue.js frontend (mobile and cordova app) for the argentinian carpooling application: Carpoolear

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Vue 53.5%
  • CSS 27.6%
  • JavaScript 18.8%
  • HTML 0.1%