Beep: mobile account vulnerability scanner

Every day, over 4 million online data records are stolen or lost. Beep tells you if your online accounts have been stolen in any of these data breaches. Just enter your email address, username, or password, and we’ll tell you if it's been hacked.

Pioneering Vue.js as a New Backend for Ionic

Beep is one of the first apps built on Vue.JS and Ionic Framework. With this combination, PHP developers no longer have to struggle with Angular to build cross platform Ionic apps. We even built our own router.

• How it works
• Installing
• Developing
  • Prerequisites
  • iOS build
  • Android build
  • Deploying
• Ionic Vue
• Theming
• Modus Create
• License

How it works

We've made sure that Beep won't end up yet another name on the list of data breaches. How? We hash all of your passwords and account information. In other words, we never store your passwords in plain text. Instead, we transform your password into a really, really long code and then, we send only the first five characters of that code to a server.

Installing

Once you clone this repo go into the terminal and install dependencies.

npm install

Now you're ready to serve the development build.

npm run serve

Developing

Beep is built with amazing libraries

• Ionic
• Vue
• Ionic-Vue
• Capacitor
• Webpack

Prerequisites

Node 8.x+ is required for development.

iOS build

Make sure you have cocoapods on your Mac OS. You can install cocoapods with gem

sudo gem install cocoapods

You can create an iOS-specific build by executing:

npm run build-ios

Android build

You will need Android SDK.

The easiest way to set it up on a Mac is with homebrew.

brew install android-sdk

On Linux you can either use your distribution's package manager

sudo apt-get install android-sdk

Or install via Flatpak or Snap

After the SDK is setup you can create an Android-specific build by executing:

npm run build-android

To create a production or debug APK you will need to sign your app. For a local debug build we have provided an example file

cp android/signing/keystore.properties.example android/signing/keystore.properties

This will rename the example file and allow you to proceed with the build process.

You may need to adjust the value of storeFile according to your platform

storeFile=~/.android/debug.keystore

Deploying

To prepare your assets for a production deployment execute:

npm run build

This will create files and assets in the dist/ directory

Run on Android

cd android
./gradlew installDebug

Ionic Vue

Ionic Vue enables Vue apps to use Ionic 4 with little to no configuration and no changes to familiar approaches. Originally a Modus Labs project, Ionic Vue became part of the Ionic framework as the official support for Vue.

Theming

For minor customizations you can edit the supplied .env file which allows you to edit the App name and status-bar colors for mobile/PWA builds.

Modifications of colors, fonts and other parts of UI are done in src/theme/common.css and .vue files in src/components/ and src/views/ which specify scoped styling rules.

For making modifications to native iOS and Android builds you will have to make changes within android/ and ios/ directories.

An in-depth description is provided by Capacitor's documentation

Configuring iOS

Configuring Android

Tests

Unit tests

To run the test suite execute:

npm test

This will confirm that any changes made to the original code did not break any existing functionality.

To extend the test suite create a new file in tests/unit/ such as new-feature.spec.js

Automated end-to-end tests

To run the end-to-end automated tests install the necessary dependencies by executing:

cd tests_root/wdio && npm install

Next make sure that Chrome browser is installed on the machine. At the moment the tests are configured to run only in Chrome. In the future support for other browsers will be added. Before actually starting the scripts make sure that the Beep web app is either running locally or a baseUrl is added in the wdio.conf.js file. By default it's running on localhost:8080.

Finally, the following command needs to be executed:

npm run test:ui

Linting

Code linting is done with ESLint and Prettier

To run a check the project for any lint errors execute:

npm run lint

E2E testing on mobile devices is brought to you by CrossBrowserTesting.

Modus Create

Modus Create is a digital product consultancy. We use a distributed team of the best talent in the world to offer a full suite of digital product design-build services; ranging from consumer facing apps, to digital migration, to agile development training, and business transformation.

This project is part of Modus Labs.

Licensing

This project is MIT licensed.