Merge branch 'main' into chore/update_buildroot_version

Author: jgoux

README.md

@@ -1,26 +1,36 @@
-# :elephant: PostgreSQL, in your browser :globe_with_meridians:
-
-`postgres-browser` uses WASM to run a full Postgres database inside the browser. 
-
-## :zap: Getting started
-
-```bash
-cd packages/pg-browser && npx serve
+<div align="center">
+  <h1 align="center">Postgres WASM</h1>
+  <p align="center">A PostgresQL server instance running in a virtual machine running in the browser<br />
+  <i>by Supabase &amp; Snaplet</i></p>
+  <img align="center" src="https://user-images.githubusercontent.com/44849/192262287-29d1ecb2-8ff7-40cb-bd1f-68d707493a86.png" alt="Snaplet, Supabase and friends" width="480">
+  <br /><br />
+  <a href="https://postgres-wasm.netlify.com">Demo</a>
+  <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
+  <a href="https://app.snaplet.dev/chat">Discord</a>
+  <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
+  <a href="https://www.snaplet.dev/">Snaplet</a>
+  <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
+  <a href="https://www.supabase.com">Supabase</a>
+</div>
+<br />
+
+## Quickstart
+
+```terminal
+cd packages/runtime && npx serve
 ```
 
 Go to http://localhost:3000 and have fun!
 
-## :brain: Architecture
-
-> TODO
+## Packages
 
-## :eyes: Going further
+This repo is split into three packages that build up the environment for running PostgresQL in the browser.
 
-- [pg-browser](/packages/pg-browser)
-- [Buildroot](/packages/buildroot)
-- [Websockproxy](/packages/websockproxy)
+- [runtime](/packages/runtime): The v86 emulator that starts the `buildroot` image
+- [Buildroot](/packages/buildroot): Scripts to build the CPU and memory snapshot run by v86.
+- [Websockproxy](/packages/websockproxy): Networking
 
-## :clap: Acknowledgements
+## Acknowledgements
 
 - [v86](https://github.com/copy/v86) which is **the** emulator for running x86 operating systems in the browser, without it none of the following projects would be possible
 - [crunchydata playground](https://www.crunchydata.com/developers/playground) for leading the way and showing the world that it was possible to run PostgreSQL in the browser

packages/buildroot/legal-info/host-licenses/acl-2.3.1/doc/COPYING

@@ -0,0 +1,43 @@
+                   AUTOCONF CONFIGURE SCRIPT EXCEPTION
+                       Version 3.0, 18 August 2009
+
+ Copyright (C) 2009 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+This Exception is an additional permission under section 7 of the GNU
+General Public License, version 3 ("GPLv3").  It applies to a given
+file that bears a notice placed by the copyright holder of the file
+stating that the file is governed by GPLv3 along with this Exception.
+
+The purpose of this Exception is to allow distribution of Autoconf's
+typical output under terms of the recipient's choice (including
+proprietary).
+
+0. Definitions
+
+"Covered Code" is the source or object code of a version of Autoconf
+that is a covered work under this License.
+
+"Normally Copied Code" for a version of Autoconf means all parts of
+its Covered Code which that version can copy from its code (i.e., not
+from its input file) into its minimally verbose, non-debugging and
+non-tracing output.
+
+"Ineligible Code" is Covered Code that is not Normally Copied Code.
+
+1. Grant of Additional Permission.
+
+You have permission to propagate output of Autoconf, even if such
+propagation would otherwise violate the terms of GPLv3.  However, if
+by modifying Autoconf you cause any Ineligible Code of the version you
+received to become Normally Copied Code of your modified version, then
+you void this Exception for the resulting covered work.  If you convey
+that resulting covered work, you must remove this Exception in accordance
+with the second paragraph of Section 7 of GPLv3.
+
+2. No Weakening of Autoconf Copyleft.
+
+The availability of this Exception does not imply any general presumption
+that third-party software is unaffected by the copyleft requirements of
+the license of Autoconf.