Skip to content

phetsims/paper-land

Repository files navigation

Paper Playground

Documentation Matrix Server Youtube Channel License

logo

Interactive Play Meets Multimodal Web Experience

Paper Playground is an open-source project for collaboratively creating multimodal web experiences by means of mapping JavaScript* code to real pieces of paper and manipulating the code in your physical space.

(*written directly or using a no/low-code component-style interface!)

We aim to support a community interested in bringing physical interaction as a means to collaboratively solve problems in codesigning virtual technology.

Paper Playground is based on the Paper Programs open-source project and has been extended to incorporate the library stack used by PhET Interactive Simulations as a convenient 2D scene creator and manager. The project focuses on enabling quick prototyping of web projects, with a particular emphasis on easy addition of audio features (like sounds and sonifications), speech description (both TTS engines and screen reader-like descriptions), and other non-visual features that are often difficult to design and develop alongside visual elements in these projects.

The ideas behind Paper Playground are simple, but the possibilities are infinite.

  1. Create programs, as many as you would like, to represent your project.
  2. Map data variables, parameters, and functions to paper position, size, shape, rotation, proximity, and use optional marker positions for more functionality.
  3. Print out the dot-covered papers that belong to those programs.
  4. Put those paper programs in front of a webcam.
  5. Watch and interact with the output of that code in your browser.
  6. Move programs around and trigger the mappings between your papers position in space and your code!
  7. Change your program code, make new papers, and keep the creativity going!

Paper Playground setup detecting paper programs that create a moon lander and control vertical thrust

Installation

See the Paper Playground Docs website for the most up to date installation instructions.

Paper Playground setup detecting paper programs that create a moon lander and control vertical position

What is coming?

Our team is focused on a few large initiatives for integrating other projects into Paper Playground and for making it more friendly for non-technical, non-JavaScript users and designers.

⭐ If these projects interest you, please join our community and take part in the development and discussion!

  1. 🔓 Creator Interface: Abstracting the JavaScript code through means of a no/low-code component style interface that assembles the data components of your programs and highlights the relationships between your programs (e.g., At a quick glance, what information is needed and passed between programs?). Check out our progress by opening the Creator page in the tool!
  2. 🤖 AI Support: Using LLMs to support a user answer the question: "How do I turn my idea for a multimodal interactive into data variables, functions, and entire programs?". We are working toward this goal by adding an optional AI assistant inside the Creator page to help generate custom JavaScript code for more complex functions!
  3. 📤 Easier API integration for paper programs to control or output to other browser displays (besides our scenery-focused Board and the legacy canvas-focused Projector), as well as new inputs such as microcontroller integration via Bluetooth and WebSockets. See our example with the Weavly educational coding project!

However, there are many other areas that the project can be expanded (see Community below for Contributing guidelines and suggestions)!

🌏🌎🌍 Join our Community! 🌏🌎🌍

📋 Roadmap

Docs

📚 Updated setup and tutorial!

Tool

📃 More examples in the hosted database highlighting the power of multimodal design!

💻 A UI for creating basic Papers without deep JavaScript knowledge!

🤖 Investigating use of LLMs to help users go from ideas to your suite of paper programs!

License

This software is licensed under the MIT license. For more information, see the LICENSE file.

Acknowledgments

This tool was adapted from Paper Programs by JP Posma, which was inspired by the work at Dynamicland.