From 313207aabba7f27cdd335bfb0a7fd11d99fd6b08 Mon Sep 17 00:00:00 2001 From: pearmini Date: Sat, 13 Sep 2025 19:44:28 -0400 Subject: [PATCH 1/4] Optimize README --- README.md | 55 ++++++++++++++++++++++++++++++------------------------- 1 file changed, 30 insertions(+), 25 deletions(-) diff --git a/README.md b/README.md index 05b7ff4..fcf2f43 100644 --- a/README.md +++ b/README.md @@ -4,9 +4,38 @@ [**Recho**](https://recho.dev/) is a free, [open-source](/LICENCE), reactive code scratchpad that echoes output inline with your code as comments — enabling beginners, developers, artists, and anyone curious to quickly code and explore through text experiments/art. Built on the reactive model of [Observable Notebook Kit](https://github.com/observablehq/notebook-kit), Recho makes coding accessible, interactive, and playful, turning every string output into a creative, in-situ experience - discover the sketches of tomorrow. +- [Editor](https://recho.dev/) 📝 - The quickest way to get started with Recho. +- [Documentation](https://recho.dev/docs/introduction) 📚 - Learn how to use Recho with our comprehensive guides. +- [Examples](https://recho.dev/examples) 🖼️ - See what you can create and draw some inspiration! +- [Contributing](https://github.com/recho-dev/recho/issues) 🙏 - We have a bunch of things that we would like you to help us build together! + ## Why Recho 💡 -We want to make code more accessible and playful. Our experience shows that **well-designed libraries don't necessarily make code accessible—the code environment does**! So here is Recho — a lighter way to code. +We want to make code more accessible and hopefully, more playful. Inspired by [P5.js Editor](https://editor.p5js.org/) and [Observable Notebook](https://observablehq.com/), we realize that _well-designed libraries don't necessarily make code accessible—the code environment does_! So here is Recho — **a lighter way to code, creatively**. We offer you a lighter beginning: + +- **Lighter Input** - We use vanilla JavaScript, and you don't have to learn extra libraries or browser specific APIs to get started with. It can help you focus more on general coding concepts and algorithms themselves. +- **Lighter Output** - We embrace text based output - an universal and timeless interface. It's concise, intuitive and efficient, which keeps your attention on the essence of code rather than the overhead of visuals. +- **Lighter Flow** - We stay in an online reactive editor - inputs and outputs both show up there. There is no need to switch context while coding. Instant feedbacks allow you better understand your code and shape ideas. +- **Lighter Purpose** - We don't need to dream big in Recho. While AI makes coding less important for "world-changing" ideas, we want to secure a place where you can code just for fun. Life can be without work, right? + +Ideally, you can be creative afterwards. You may find the minimalism of ASCII/text art both fascinating and inspiring. Coding can become a new way to express yourself and explore the world. That’s the success of Recho! + +## What's Next 🔥 + +Recho is still in its early stage, there are a lot of areas we want to explore and build with the community. Especially, we are interested in the following things: + +- **More Examples** - Examples attract users and shape tools. We would love to have examples in different areas (text analysis, data viz, graphics, concrete poetry, algorithms, etc,) and working with external libraries (D3, Lodash, ml5, Tone, etc,). They don't have to be complicated or perfect. One thing to share is enough. Open a pull request to share yours today! +- **Text Based Libraries** - Best practices deserve to be seen by more people. If you find some algorithms you are using helpful for others, don't hesitate to package them into libraries. Remember, they can be light! +- **Diverse Programming Languages** - Recho begins with JavaScript, but isn’t limited to it—coding has no boundaries. As long as a programming language can be transpiled to JavaScript, it can incorporated with Recho. It can be main steam (Python, Rust), be academic (mlscript) and be creative (wenyan‑lang). The best part is that it doesn't have to be production ready or have a real life usage. Just providing a new way to code or think is cool. Want to add your favorite language to Recho or share your "toys"? Talk to us! + +Of course, there are a lot of editor related features on the way! + +- **Reactive Inputs** - Reactivity right in the editor. (slider, checkbox, radio, etc,.) +- **Visual Enhancement** - More expressive and informative editor. (dark theme, ANSI escape codes, etc,.) +- **Interactivity** - Response to user inputs. (mouse, keyboard, etc,.) +- ... + +Also, we have plans to provide cloud storage services. But we don't want to overcomplicated things at this point, so any thoughts, comments and suggestions are welcome! ## A Quick Example 🚀 @@ -71,30 +100,6 @@ function map(x, d0, d1, r0, r1) { } ``` -## Editor 📝 - -The quickest way to get started with Recho. - -https://recho.dev/ - -## Documentation 📚 - -Learn how to use Recho with our comprehensive guides. - -https://recho.dev/docs/introduction - -## Examples 🖼️ - -See what you can create and draw some inspiration! - -https://recho.dev/examples - -## Contributing 🙏 - -We have a bundle of features that we would like you to help us build together! - -https://github.com/recho-dev/recho/issues - ## License 📄 ISC © [Recho](https://github.com/recho-dev) From d142c3bb81228387f80c0a84d36a1a88494b137e Mon Sep 17 00:00:00 2001 From: pearmini Date: Sun, 14 Sep 2025 12:56:06 -0400 Subject: [PATCH 2/4] Fix grammar errors --- README.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index fcf2f43..997b2f0 100644 --- a/README.md +++ b/README.md @@ -14,28 +14,28 @@ We want to make code more accessible and hopefully, more playful. Inspired by [P5.js Editor](https://editor.p5js.org/) and [Observable Notebook](https://observablehq.com/), we realize that _well-designed libraries don't necessarily make code accessible—the code environment does_! So here is Recho — **a lighter way to code, creatively**. We offer you a lighter beginning: - **Lighter Input** - We use vanilla JavaScript, and you don't have to learn extra libraries or browser specific APIs to get started with. It can help you focus more on general coding concepts and algorithms themselves. -- **Lighter Output** - We embrace text based output - an universal and timeless interface. It's concise, intuitive and efficient, which keeps your attention on the essence of code rather than the overhead of visuals. -- **Lighter Flow** - We stay in an online reactive editor - inputs and outputs both show up there. There is no need to switch context while coding. Instant feedbacks allow you better understand your code and shape ideas. +- **Lighter Output** - We embrace text-based output - a universal and timeless interface. It's concise, intuitive, and efficient, which keeps your attention on the essence of code rather than the overhead of visuals. +- **Lighter Flow** - We stay in an online reactive editor - inputs and outputs both show up there. There is no need to switch context while coding. Instant feedback allows you to better understand your code and shape ideas. - **Lighter Purpose** - We don't need to dream big in Recho. While AI makes coding less important for "world-changing" ideas, we want to secure a place where you can code just for fun. Life can be without work, right? Ideally, you can be creative afterwards. You may find the minimalism of ASCII/text art both fascinating and inspiring. Coding can become a new way to express yourself and explore the world. That’s the success of Recho! ## What's Next 🔥 -Recho is still in its early stage, there are a lot of areas we want to explore and build with the community. Especially, we are interested in the following things: +Recho is still in its early stage. There are a lot of areas we want to explore and build with the community. Especially, we are interested in the following things: -- **More Examples** - Examples attract users and shape tools. We would love to have examples in different areas (text analysis, data viz, graphics, concrete poetry, algorithms, etc,) and working with external libraries (D3, Lodash, ml5, Tone, etc,). They don't have to be complicated or perfect. One thing to share is enough. Open a pull request to share yours today! +- **More Examples** - Examples attract users and shape tools. We would love to have examples in different areas (text analysis, data viz, graphics, concrete poetry, algorithms, etc.) and working with external libraries (D3, Lodash, ml5, Tone, etc.). They don't have to be complicated or perfect. One thing to share is enough. Open a pull request to share yours today! - **Text Based Libraries** - Best practices deserve to be seen by more people. If you find some algorithms you are using helpful for others, don't hesitate to package them into libraries. Remember, they can be light! -- **Diverse Programming Languages** - Recho begins with JavaScript, but isn’t limited to it—coding has no boundaries. As long as a programming language can be transpiled to JavaScript, it can incorporated with Recho. It can be main steam (Python, Rust), be academic (mlscript) and be creative (wenyan‑lang). The best part is that it doesn't have to be production ready or have a real life usage. Just providing a new way to code or think is cool. Want to add your favorite language to Recho or share your "toys"? Talk to us! +- **Diverse Programming Languages** - Recho begins with JavaScript, but isn't limited to it—coding has no boundaries. As long as a programming language can be transpiled to JavaScript, it can be incorporated with Recho. It can be mainstream (Python, Rust), academic (mlscript), or creative (wenyan‑lang). The best part is that it doesn't have to be production-ready or have real-life usage. Just providing a new way to code or think is cool. Want to add your favorite language to Recho or share your "toys"? Talk to us! Of course, there are a lot of editor related features on the way! -- **Reactive Inputs** - Reactivity right in the editor. (slider, checkbox, radio, etc,.) -- **Visual Enhancement** - More expressive and informative editor. (dark theme, ANSI escape codes, etc,.) -- **Interactivity** - Response to user inputs. (mouse, keyboard, etc,.) +- **Reactive Inputs** - Reactivity right in the editor. (slider, checkbox, radio, etc.) +- **Visual Enhancement** - More expressive and informative editor. (dark theme, ANSI escape codes, etc.) +- **Interactivity** - Response to user inputs. (mouse, keyboard, etc.) - ... -Also, we have plans to provide cloud storage services. But we don't want to overcomplicated things at this point, so any thoughts, comments and suggestions are welcome! +Also, we have plans to provide cloud storage services. But we don't want to overcomplicate things at this point, so any thoughts, comments, and suggestions are welcome! ## A Quick Example 🚀 From 9a6ee8736ca1cd54030a8fb2d8c17b4bda6af070 Mon Sep 17 00:00:00 2001 From: pearmini Date: Sun, 14 Sep 2025 13:18:29 -0400 Subject: [PATCH 3/4] Add interactions with LLMs --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 997b2f0..2021c3e 100644 --- a/README.md +++ b/README.md @@ -27,6 +27,7 @@ Recho is still in its early stage. There are a lot of areas we want to explore a - **More Examples** - Examples attract users and shape tools. We would love to have examples in different areas (text analysis, data viz, graphics, concrete poetry, algorithms, etc.) and working with external libraries (D3, Lodash, ml5, Tone, etc.). They don't have to be complicated or perfect. One thing to share is enough. Open a pull request to share yours today! - **Text Based Libraries** - Best practices deserve to be seen by more people. If you find some algorithms you are using helpful for others, don't hesitate to package them into libraries. Remember, they can be light! - **Diverse Programming Languages** - Recho begins with JavaScript, but isn't limited to it—coding has no boundaries. As long as a programming language can be transpiled to JavaScript, it can be incorporated with Recho. It can be mainstream (Python, Rust), academic (mlscript), or creative (wenyan‑lang). The best part is that it doesn't have to be production-ready or have real-life usage. Just providing a new way to code or think is cool. Want to add your favorite language to Recho or share your "toys"? Talk to us! +- **Interactions with LLMs** - Recho’s text-first approach is ideal for LLMs. Rather than letting the LLM write code directly, you can use code as input: fusing files, turning text into pixel outputs, and more. We want to exploring the possibilities. Of course, there are a lot of editor related features on the way! From 6a07e9f618d870d4e064b5e9d58edbb98c0ffc47 Mon Sep 17 00:00:00 2001 From: pearmini Date: Sun, 14 Sep 2025 13:22:06 -0400 Subject: [PATCH 4/4] Add some links --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 2021c3e..987cdf0 100644 --- a/README.md +++ b/README.md @@ -24,9 +24,9 @@ Ideally, you can be creative afterwards. You may find the minimalism of ASCII/te Recho is still in its early stage. There are a lot of areas we want to explore and build with the community. Especially, we are interested in the following things: -- **More Examples** - Examples attract users and shape tools. We would love to have examples in different areas (text analysis, data viz, graphics, concrete poetry, algorithms, etc.) and working with external libraries (D3, Lodash, ml5, Tone, etc.). They don't have to be complicated or perfect. One thing to share is enough. Open a pull request to share yours today! +- **More Examples** - Examples attract users and shape tools. We would love to have examples in different areas (text analysis, data viz, graphics, concrete poetry, algorithms, etc.) and working with external libraries ([D3](https://d3js.org/), [Lodash](https://lodash.com/), [ml5](https://ml5js.org/), [Tone](https://tonejs.github.io/), etc.). They don't have to be complicated or perfect. One thing to share is enough. Open a [pull request](https://github.com/recho-dev/recho/new/main/app/examples) to share yours today! - **Text Based Libraries** - Best practices deserve to be seen by more people. If you find some algorithms you are using helpful for others, don't hesitate to package them into libraries. Remember, they can be light! -- **Diverse Programming Languages** - Recho begins with JavaScript, but isn't limited to it—coding has no boundaries. As long as a programming language can be transpiled to JavaScript, it can be incorporated with Recho. It can be mainstream (Python, Rust), academic (mlscript), or creative (wenyan‑lang). The best part is that it doesn't have to be production-ready or have real-life usage. Just providing a new way to code or think is cool. Want to add your favorite language to Recho or share your "toys"? Talk to us! +- **Diverse Programming Languages** - Recho begins with JavaScript, but isn't limited to it—coding has no boundaries. As long as a programming language can be transpiled to JavaScript, it can be incorporated with Recho. It can be mainstream ([Python](https://www.python.org/), [Rust](https://www.rust-lang.org/)), academic ([mlscript](https://github.com/hkust-taco/mlscript)), or creative ([wenyan‑lang](https://wy-lang.org/)). The best part is that it doesn't have to be production-ready or have real-life usage. Just providing a new way to code or think is cool. Want to add your favorite language to Recho or share your "toys"? Talk to us! - **Interactions with LLMs** - Recho’s text-first approach is ideal for LLMs. Rather than letting the LLM write code directly, you can use code as input: fusing files, turning text into pixel outputs, and more. We want to exploring the possibilities. Of course, there are a lot of editor related features on the way!