robbobfrh84 / gas-up

Build dynamic client-side apps using Google Sheets as a database

Welcome to the "GAS Up" Github repository ⛽️ 🚀

Build dynamic client-side apps using Google Sheets as a database

• Build, read, update and delete sheets with client-side API requests.
• The connected google sheet is laid out like a database with tables and entries.
• Customize your cloud "back-end" with an open-source Google Apps Script(GAS) library!

Accessible & real-time updatable data, for a quick and light full-stack

• Build microsites
• Prototype web apps
• Host static data
• Integrate Iot apps and logging,
• Or, whatever else some wacky person might dream up 🤔😃🤯!

Getting started

For a "quick guide" to get up and running in a couple minutes, visit the Getting started section of our wiki.

---

GAS Up Stack

A complete GAS Up application consists of three major components.

• The Client-side API library
• A Google Sheet.
• The GAS Up Apps Script Library "bound" to that Google Sheet.

Documentation

All the documentation lives in our github wiki page.

Questions, bugs, issues, help, existentail crises relating to GAS Up

Visit our discussion forum!

---

How Does this work?

Google Sheets allow for javascript to control and automate Google Sheets with what they call "Google Apps Scripts". To see a simple example of this, start by creating a new Google Sheet.

• Select: "Extensions" > "Script editor" to see where you'd code your "Google Apps Script" app.
• Here, you can also add Libraries that have already been created to do special things!

GAS Up is an Apps Script library, and it's open source!

You don't even need to add any Google Apps Script code of your own to get started.

• GAS Up serves the API for client-side apps directly. This allows the application to read and update data from any Google Sheet you own and allow access to. In addition, the Google Sheet itself can remain private.

• For instance, say you want to use GAS Up to create a simple page view counter. The Google sheet that is being updated can remain private, while the client-side app is still allowed to "ping" the GAS Up API to incremented a cells values each time a webpage is loaded to a browser.

---

Built with GAS Up 🏗

tobob.earth

A personal portfolio for Bob Main. Built with and managed with GAS Up while also tracking basic site analytic and root data!

• Web App: https://tobob.earth/#landing
• Public Google Sheet: https://docs.google.com/spreadsheets/d/1h7AQcnPrSPL9kwPwcBwkRRHB_VIdJ-NszRY1eYJHf24/edit#gid=1906007068
• Github Repository: https://github.com/robbobfrh84/tobob.earth

✨ ✨ 🔮 ✨ ✨

Top 5

A web app using GAS Up to host top 5 rankings of everything that's important, relevant reverent, and most importantly irrelevant!

• Web App: https://robbobfrh84.github.io/gas-up/examples/top5
• Public Google Sheet: https://docs.google.com/spreadsheets/d/1KrabEzohbEZwELTIqE7cRjLIQaGJFS95I2qR5mw4FpU/edit#gid=685369503
• Github Repository: https://github.com/robbobfrh84/gas-up/tree/master/examples/top5

✨ ✨ 🔮 ✨ ✨

gas-up's Issues

Client side library setup doesn't work

What is the issue?

The wiki documentation page suggests linking the gas up library by putting this in index.html
<script src="https://github.com/robbobfrh84/gas-up/blob/master/client/Gasup.js"></script>
however, Github doesn't seem to allow HTML to pull the javascript file from this link.

How to fix

It may be better to use a CDN like jsdelivr:
<script src="https://cdn.jsdelivr.net/gh/robbobfrh84/gas-up/client/Gasup.js"></script>