Init workspace

.gitignore

@@ -12,3 +12,8 @@ Cargo.lock
 
 # MSVC Windows builds of rustc generate these, which store debugging information
 *.pdb
+
+
+# Added by cargo
+
+/target

Cargo.toml

@@ -0,0 +1,3 @@
+[workspace]
+resolver = "2"
+members = ["coco-core"]

README.md

@@ -1,3 +1,11 @@
 # COCO-8
 
 COCO-8 (or 👻-8) is a fantasy VM for games and creative coding. COCO-8 runs on Wasm and it's written in Rust.
+
+COCO-8 is [made of these parts](./docs/architecture.md):
+
+- `coco-core`, the virtual CPU. It is basically [Uxn](https://wiki.xxiivv.com/site/uxn.html), as _documented_ (COCO-8 follows the documented spec, not the reference implementation of Uxn).
+
+- Devices, which interface with the CPU and provide input / output with peripherals or other systems (e.g. video, audio, controller input, etc.).
+
+- A web-based GUI, for users to load and run COCO-8 roms.

coco-core/Cargo.toml

@@ -0,0 +1,6 @@
+[package]
+name = "coco-core"
+version = "0.1.0"
+edition = "2021"
+
+[dependencies]

coco-core/README.md

@@ -0,0 +1,3 @@
+# coco-core
+
+This is the CPU part of COCO-8. It mimics the design of the [Uxn spec](https://wiki.xxiivv.com/site/uxn.html) and its [opcodes](https://wiki.xxiivv.com/site/uxntal_opcodes.html).

coco-core/src/lib.rs

@@ -0,0 +1,14 @@
+pub fn add(left: usize, right: usize) -> usize {
+    left + right
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn it_works() {
+        let result = add(2, 2);
+        assert_eq!(result, 4);
+    }
+}