{"id":13468162,"url":"https://github.com/just-js/just","last_synced_at":"2025-04-14T00:59:08.796Z","repository":{"id":40000756,"uuid":"280313733","full_name":"just-js/just","owner":"just-js","description":"the only javascript runtime to hit no.1 on techempower :fire:","archived":false,"fork":false,"pushed_at":"2023-11-17T12:28:54.000Z","size":345,"stargazers_count":3712,"open_issues_count":0,"forks_count":125,"subscribers_count":61,"default_branch":"main","last_synced_at":"2025-04-14T00:58:49.325Z","etag":null,"topics":["javascript","linux","runtime","system-programming"],"latest_commit_sha":null,"homepage":"https://just.billywhizz.io/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/just-js.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2020-07-17T03:07:34.000Z","updated_at":"2025-04-12T08:27:44.000Z","dependencies_parsed_at":"2023-11-17T14:12:21.638Z","dependency_job_id":"fbec5a98-bca0-4299-baac-3a6d6bb8164b","html_url":"https://github.com/just-js/just","commit_stats":null,"previous_names":[],"tags_count":36,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/just-js%2Fjust","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/just-js%2Fjust/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/just-js%2Fjust/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/just-js%2Fjust/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/just-js","download_url":"https://codeload.github.com/just-js/just/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248804790,"owners_count":21164132,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["javascript","linux","runtime","system-programming"],"created_at":"2024-07-31T15:01:06.443Z","updated_at":"2025-04-14T00:59:08.764Z","avatar_url":"https://github.com/just-js.png","language":"JavaScript","readme":"# Just [![Gitpod ready-to-code](https://img.shields.io/badge/Gitpod-ready--to--code-908a85?logo=gitpod)](https://gitpod.io/#https://github.com/just-js/just)\n\n## *** Attention ***\n\n**17 Nov 2023**\n\nThis project is not being actively maintained in it's current state. please see [lo](https://github.com/just-js/lo) for a new, low-level JavaScript runtime i am working on. Very shortly this should be in a place where I will be able to \"resurrect\" the \"just\" project and base it on lo. Keep an eye out over coming weeks on [twitter](https://twitter.com/justjs14)  or come join us on [discord](https://discord.gg/ZnNsBwaBKr) to discuss the new work. 🙏 🚀\n\n## Build and Run\n\nCurrently working on modern linux (debian/ubuntu and alpine tested) on x86_64\n\n```bash\n# download and run the build script\nsh -c \"$(curl -sSL https://raw.githubusercontent.com/just-js/just/current/install.sh)\"\n# install just binary to /usr/local/bin\nmake -C just install\n# export the just home directory\nexport JUST_HOME=$(pwd)/just\nexport JUST_TARGET=$JUST_HOME\n# if you don't want to install, add JUST_HOME to SPATH\nexport PATH=$PATH:$JUST_HOME\n# run a shell\njust\n```\n\n## Create a new Application\n```bash\n# initialise a new application in the hello directory\njust init hello\ncd hello\n# build hello app\njust build hello.js --clean --static\n./hello\n```\n\n## Command Line Options\n\n### Run a Just shell/repl\n```bash\njust\n```\n\n### Pipe a script to stdin\n```bash\ncat hello.js | just --\n```\n\n### Eval some Javascript passed as an argument\n```bash\njust eval \"just.print(just.memoryUsage().rss)\"\n```\n\n### Run a script\n```bash\njust hello.js\n```\n\n### Initialise a new project and build it\n```bash\njust init hello\ncd hello\njust build\n```\n\n### Clean a built project\n```bash\njust clean\n```\n\n## Documentation\n\nComing soon...\n\n## Philosophy/Goals\n- small, secure, robust and performant js runtime for linux\n- small codebase. easy to understand and hack\n- very simple layer on top of system calls, v8 and c/c++ standard libraries\n- minimal use of classes/function templates and OO - \"c\" in javascript\n- favour return codes over exceptions\n- platform for building system software on linux in javascript\n- as close to native performance as possible\n- secure by default\n- avoid abstraction as much as possible. abstractions can be built in userland\n- commonjs modules, no support for ES modules\n- non-async by default - can do blocking calls and not use the event loop\n- event loop in JS-land. full control over epoll api\n- small standard library - leave as much to userland as possible. focus on primitives needed to build higher level abstractions\n- useful as a teaching/learning platform for linux system programming and learning more about javascript and v8 internals\n- small number of source files\n- minimal dependencies - g++ and make only\n- keep LOC as small as possible \u003c 5k\n- allocate as little as possible on v8 heap\n","funding_links":[],"categories":["JavaScript","Runtimes"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjust-js%2Fjust","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjust-js%2Fjust","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjust-js%2Fjust/lists"}