Skip to content

samuelmtimbo/unit

main
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
January 17, 2022 09:42
src
October 8, 2023 20:14
June 4, 2022 16:08
December 19, 2021 05:52
December 19, 2021 05:52
January 9, 2022 00:29
December 19, 2021 05:52
December 19, 2021 05:52

Unit

Next Generation Visual Programming System

Unit merge sort example

Unit

Unit is a General Purpose Visual Programming Language and Environment built with a primary focus on Developer Experience.

It is heavily inspired by Live, Data Flow, Reactive, Functional and Object Oriented Programming paradigms. Formally, units are Multi Input Multi Output (MIMO) Finite State Machines (FSM). A program in Unit is represented as a Graph.

The Unit Programming Language was developed in close junction to the Unit Programming Environment, which is a Web application built for easy composition of new units. The environment is designed to feel visual and kinesthetic, giving the perception of Direct Manipulation of Live Virtual Objects. The Unit Programming experience is minimalistic, ergonomic, mobile, and can be performed through a variety of input devices, and editing can be partially expressed through Drawing, Gesture and Voice.

Unit is similar in concept to the Unix shell. For a seasoned programmer, Unit should feel like the 2D evolution of the Command Line Interface (CLI) where units' (commands) inputs and outputs (stdin/stdout/stderr) can be piped together into a graph (script). In fact, Unit can be thought of as a re-exploration of the Unix Philosophy in the context of modern Software Engineering and Web Development.

The Unit system is set to grow into a simple and approachable Web Operating System, which is sandboxed by default, enabling a new era of Software Sharing and Collaboration, unifying the currently fragmented Computer Experience.

For an introduction to Unit Programming, visit Getting Started.

The broader design philosophy behind Unit is discussed in Concept.

To jump right into the official Unit Programming Environment, visit unit.land (beta).

Development

Install npm and git if you haven't already.

Clone this repository:

git clone git@github.com:samuelmtimbo/unit.git

Get into the unit folder:

cd unit

Install:

npm install

Setup:

npm run setup

Start a local unit server:

npm start

For development mode:

npm run watch

Library

unit can be used as a library in another JavaScript project, both on Web and Node.js.

npm install --save @_unit/unit

To install unit globally:

npm install --global @_unit/unit

Then to start a local server:

unit

Test

npm test

Links

List of related web applications (beta):

unit.md

Redirect to the official unit source code.

unit.land

Fully local version of the Unit Environment.

Any *.unit.land subdomain represents a completely isolated instance of the Unit system.

unit.moe

Appending #url to https://unit.moe will attempt to encapsulate the unit served at that URL in a graph editor. This is helpful for debugging an open unit website, for instance:

https://unit.moe#https://unit.land will show the code for https://unit.land.

https://unit.moe#https://unit.tools will show the code for https://unit.tools.

Documentation

The unit Programming Environment was designed to be learnable by Experimentation and Exploration. Visual and written documentation about each unit can be accessed using Info Mode.

This codebase is a TypeScript implementation of the unit Programming Language Spec with an accompanying Web based Programming Environment. I tried to make it as clean and organized as I could while still maintaining a space for experimentation. Some folders contain a README.md file with information about that piece of the architecture.

Contributing

First of all, please feel free to clone or fork Unit's source code.

This is the best place to learn about Unit's design and implementation, and the official channel for Open Source collaboration.

This repository is open for pull requests from contributors.

If you want to collaborate with Unit's development. Please hit me up at @io_sammt.

If you have a feature idea or hit a malfunction, this is a workflow I like to follow:

  1. Iterate over a solution on top the latest main, testing it locally until it works and the code is clean;
  2. Open a pull request explaining the problem and solution;
  3. Iterate over it to make sure the change is positive and aligned with Unit's design and vision.

The Unit project has nearly infinite space for creative freedom, invention, and intimacy, which is what motivated me and made it possible.

Ultimately, the goal is for everyone to have an easy to use, powerful, customizable and flexible visual system where one can build anything with absolute freedom, without ever having to leave it.

Backlog

All currently available primitives live in the system folder.

Unit system API is composed of logical, platform (frontend and backend) and "operating system" units.

The direction of growth is feature parity with Web and a subset of NodeJS (not native to the Web), like TCP and HTTP

Check out these examples of primitive classes: add (+ operation), oscilator node (Web Audio API), and peer transmitter (simplified Web RTC).

The default Unit system comes with a collection of useful unit graphs out of the box. Take a look at what a graph looks like in JSON: if else and range.

Community

If you have a question or a suggestion related to Unit, or if you just want to talk about the future of Programming, or if you wish to join Unit team, feel free to message me at @io_sammt.

For weekly updates about Unit's development, including thoughts about vision and roadmap, follow us on Twitter @io_unit.

We hope you enjoy Unit and invite you to be part of our community!

License

MIT License

Copyright 2021 UNIT IO, Inc