Giter Club home page Giter Club logo

ynab-api-starter-kit's Introduction

YNAB API Starter Kit

Want to build a web app with the YNAB API but not sure how to get started?

Try this YNAB API Starter Kit!

Demo

View a live demo of what this project will start off looking like or take a look below.

kapture 2018-03-28 at 12 37 23

Usage

  • Install Node.js.
  • In your terminal, run npx ynab-api-starter-kit my-ynab-app

This will:

  • Create a copy of this project on your computer.
  • Install all the dependencies.
  • Start up the server ready for development.

Alternatively

If you're looking for a little less magic:

  • Use git to clone it: git clone https://github.com/ynab/ynab-api-starter-kit
  • From within the folder, run npm install
  • Then run npm start

Create An OAuth Application

Go to the YNAB Developer Settings and create a new application.

You'll see your client id, client secret and redirect URI(s).

Copy and paste your client id and redirect URI into the src/config.json file.

Development

Check out the YNAB API Documentation for more information on how to use the YNAB API.

This example uses Vue.js but it is not required. Feel free to use whatever framework or libraries you prefer.

npm start

Runs the development server (defaults to localhost:8080) and watches for changes.

npm run build

Builds the production assets for deployment. This will build to dist/build.js which the index.html will load.

In the script portion of this page, you can see how to build an OAuth URI to obtain an access token for the API.

It also has some examples on retrieving budgets and transactions.

This displays all the transactions when you've got them. It also has an example of using utils.convertMilliUnitsToCurrencyAmount to convert the milliunits that YNAB uses into the currency format of the budget.

Deployment

Deploy

GitHub Pages

If you have a GitHub account, fork this repo. You can now modify your fork, run npm run build, commit and push the code. Your app will be live on https://[yourgithubacccount].github.io/ynab-api-starter-kit/.

License

Copyright (c) 2018 You Need A Budget, LLC

Licensed under the Apache-2.0 license

ynab-api-starter-kit's People

Contributors

bradymholt avatar shama avatar

Watchers

 avatar

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.