Skip to content

A simple mobile application for reading an ISBN number from a book's barcode, then retrieving its rating from the Goodreads API.

Notifications You must be signed in to change notification settings

lukaswhite/mobile-isbn-reader

Repository files navigation

Mobile ISBN Reader

A simple mobile application developed with the Ionic Framework for reading ISBN numbers from (real!) books via their barcodes. Once you've scanned a book, it uses the Goodreads API to retrieve the rating of the book and displays it along with a button which links directly to the book in question on the Goodreads website.

A screenshot of the application in action

There are a few steps you'll need to take to get this working.

First, Run npm install.

Then create a file named config.json in the project root, which looks like this:

{
  "services": {
    "goodreads": {
      "key": "SUBSTITUTE-YOUR-KEY-HERE"
    }
  }
}

You'll need to obtain a developer key and substitute it in at the appropriate place.

Run the following command:

gulp config

This will generate an Angular module which encapsulates the contents of the config.json file you just created.

You'll need to add the appropriate platform(s):

ionic platform add android
ionic platform add ios

You also need a couple of Cordova plugins:

cordova plugin add https://github.com/wildabeast/BarcodeScanner.git 
ionic plugin add cordova-plugin-inappbrowser

With all that in place, you should be able to run it on your device:

ionic run android
ionic run ios

The application uses a barcode reader, so obviously you need a real device to run it.

Application icon by Sergei Kokota and licensed under Creative Commons Attribution 2.5 generic.

About

A simple mobile application for reading an ISBN number from a book's barcode, then retrieving its rating from the Goodreads API.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published