Skip to content

Kodular/TinyWebDB-OneClick

Repository files navigation

TinyWebDB OneClick

A modern, cloud-agnostic implementation of TinyWebDB for App Inventor with one-click deployments to multiple cloud providers.

What is TinyWebDB?

TinyWebDB is a simple key-value web service designed for App Inventor for Android. It provides a RESTful API for storing and retrieving tag-value pairs, making it easy for mobile apps to persist data in the cloud.

Original TinyWebDB Documentation (MIT)

Quick Start

Pick the hosting and storage option that best fits your needs:

Hosting Database Deploy
Cloudflare Workers KV (Key-Value) Deploy
Cloudflare Workers D1 (SQLite) Deploy
Cloudflare Workers R2 (Object Storage) Deploy
Vercel Edge Functions KV (Redis) Deploy with Vercel
Vercel Edge Functions Postgres Deploy with Vercel
Vercel Functions Blob Storage Deploy with Vercel

Once deployed, make sure you update the ServiceURL property in your TinyWebDB component with the deployed URL. Some common URL patterns for the providers above are:

  • Cloudflare: https://project-name.account-name.workers.dev
  • Vercel: https://project-name-blob3.vercel.app

When setting the ServiceURL, make sure it starts with https:// and does NOT end with /.

Database Comparison

Note that Vercel does not "natively" offer a database option (except for the Blob storage). Instead, different providers are offered in a marketplace.
Still, 1-click deployments, but specific limits may vary from one option within the same "database type" to another depending on the provider.

Database Type Read Latency Consistency Max Value Size Free Tier
Cloudflare KV Key-Value <1ms Eventual 25 MB 100K reads/day
Cloudflare D1 SQLite ~5ms Strong ~1 GB 5M reads/day
Cloudflare R2 Object Storage ~10ms Strong Unlimited 10 GB storage
Vercel KV Redis <1ms Eventual Depends Depends
Vercel Postgres PostgreSQL ~5ms Strong Depends Depends
Vercel Blob Object Storage ~10ms Strong 500 MB/blob 100 MB storage

Detailed setup guides:

Contributing

Contributions are welcome! Please read CONTRIBUTING.md for:

  • Development setup
  • Architecture overview
  • How to add new storage adapters
  • Testing guidelines
  • Pull request process

License

MIT - See LICENSE file for details

Credits

Based on the original TinyWebDB by David Wolber and Hal Abelson.

About

TinyWebDB for Kodular / App Inventor - 1-Click Deployments

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published