carpoolear

Carpoolear calls itself the first Argentine Facebook app for sharing car trips, built as a Vue.js frontend with a cordova mobile app and a codebase that can host several apps at once.

Carpoolear is the open source Vue.js frontend, mobile and cordova included, for an Argentine carpooling application. The README calls it the first Argentine Facebook app that lets users of that social network share car trips with other users. It is framed as an ad hoc customization for Argentina of the carpooling philosophy, the practice of sharing car trips with other people on a daily basis. The README notes that carpooling is popular in the USA and Europe, where it is done in an organized way to increase the number of trips shared with new people beyond neighbors and friends.

The branch is multi project, so a single source code can hold multiple apps. To start a new one, you pick a name, clone the default folder inside the projects directory, and customize the assets: google-services.js, config.xml, and images. The config.xml for cordova-plugin-facebook4 needs your Facebook APP ID and APP NAME. For customized CSS or Vue modules like main.css, you copy the file into the same folder named main.YOUR-PROJECT-NAME.css, and webpack resolves the right file at compile time. Finally you clone dev.env.js and prod.env.js from the config folder into project named versions and fill in your values.

Testing is split in two. The e2e folder holds full end-to-end tests that require a running backend, while e2e-frontend holds frontend only tests with all API calls mocked so no backend is needed. Frontend tests run automatically on every push and pull request to master through the Frontend Tests GitHub Action.

A config table documents a long list of properties: the admin email, the app name, a target app used only in development, country and locale settings for Open Street Map, the home redirection URL, and toggles like validated drivers, trip stars, custom login headers, and a footer. There are modules for trip seats payment, user request limits, an API that calculates trip price, a fuel price value, Facebook login, onboarding cards, and more. The table is where a new project's setup details actually live.

• Source 1 · Project repository
• Source 2 · README