Skip to content

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:

HostingDatabaseDeploy
Cloudflare WorkersKV (Key-Value)Deploy
Cloudflare WorkersD1 (SQLite)Deploy
Cloudflare WorkersR2 (Object Storage)Deploy
Vercel Edge FunctionsKV (Redis)Deploy with Vercel
Vercel Edge FunctionsPostgresDeploy with Vercel
Vercel FunctionsBlob StorageDeploy 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.

DatabaseTypeRead LatencyConsistencyMax Value SizeFree Tier
Cloudflare KVKey-Value<1msEventual25 MB100K reads/day
Cloudflare D1SQLite~5msStrong~1 GB5M reads/day
Cloudflare R2Object Storage~10msStrongUnlimited10 GB storage
Vercel KVRedis<1msEventualDependsDepends
Vercel PostgresPostgreSQL~5msStrongDependsDepends
Vercel BlobObject Storage~10msStrong500 MB/blob100 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

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages