{"id":13876191,"url":"https://github.com/sonnyt/just","last_synced_at":"2026-01-29T14:39:58.444Z","repository":{"id":37206013,"uuid":"449471949","full_name":"sonnyt/just","owner":"sonnyt","description":"Zero config TypeScript build and development toolkit.","archived":false,"fork":false,"pushed_at":"2024-01-11T17:24:16.000Z","size":728,"stargazers_count":198,"open_issues_count":4,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-10-26T17:27:20.522Z","etag":null,"topics":["cli","development","nodejs","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/sonnyt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2022-01-18T22:46:54.000Z","updated_at":"2025-10-23T03:44:03.000Z","dependencies_parsed_at":"2024-01-13T19:50:51.404Z","dependency_job_id":null,"html_url":"https://github.com/sonnyt/just","commit_stats":{"total_commits":65,"total_committers":2,"mean_commits":32.5,"dds":0.03076923076923077,"last_synced_commit":"0d769cd5c8947cdc19aab540aff227663387b791"},"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/sonnyt/just","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sonnyt%2Fjust","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sonnyt%2Fjust/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sonnyt%2Fjust/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sonnyt%2Fjust/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sonnyt","download_url":"https://codeload.github.com/sonnyt/just/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sonnyt%2Fjust/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28879873,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-29T10:31:27.438Z","status":"ssl_error","status_checked_at":"2026-01-29T10:31:01.017Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["cli","development","nodejs","typescript"],"created_at":"2024-08-06T06:01:07.462Z","updated_at":"2026-01-29T14:39:58.408Z","avatar_url":"https://github.com/sonnyt.png","language":"TypeScript","funding_links":[],"categories":["TypeScript","cli"],"sub_categories":[],"readme":"# Just ![GitHub tag (latest SemVer pre-release)](https://img.shields.io/github/v/tag/sonnyt/just?include_prereleases) ![NPM Version](https://img.shields.io/npm/v/%40sonnyt%2Fjust) ![GitHub](https://img.shields.io/github/license/sonnyt/just) ![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/sonnyt/just/test.yml)\nZero config TypeScript build and development toolkit.\n\n## Features\n- Fast [SWC](https://swc.rs/) compiler\n- TypeScript type check support\n- Live reload support\n- `.env` file support\n- Path alias support\n- Typescript script runner\n- REPL support\n\n## Install\n```shell\n# Locally in your project.\nnpm install -D @sonnyt/just\n\n# Or globally\nnpm install -g @sonnyt/just\n```\n\n## Usage\nTo start a dev server in the root of your project just (😉) run:\n```shell\njust dev\n```\n\nTo build:\n```shell\njust build\n```\n\n## Commands\n\n### Build\n`just build [options] [files]`\n\nCompiles the application for production deployment.\n\n**Arguments**\n- `files` - glob file path to compile. If not present, `includes` from config.json is used.\n\n**Options**\n|Option|Default|Description|\n|:--|:--|:--|\n|`--transpile-only`|off|disables type checking|\n|`--out-dir \u003coutDir\u003e`|`compilerOptions.outDir`|output folder for all emitted files|\n|`--no-color`|off|disables output color|\n|`--debug`|false|enables debug logging|\n|`-c, --config \u003cconfig\u003e`|[default](#default-typescript-config)|path to typescript configuration file|\n\n### Dev\n\n`just dev [options] [entry]`\n\nStarts the application in development mode. Watches for any file changes and live reloads the server.\n\n**Arguments**\n- `entry` - server entry path to start. If not present, `main` from package.json is used.\n\n**Options**\n|Option|Default|Description|\n|:--|:--|:--|\n|`-p, --port \u003cport\u003e`|null|server port used in `process.env.PORT`|\n|`--type-check`|false|enables type checking|\n|`--no-color`|off|disables output color|\n|`--debug`|false|enables debug logging|\n|`-c, --config \u003cconfig\u003e`|[default](#default-typescript-config)|path to typescript configuration file|\n\n### Run\n`just run [options] \u003ccommand\u003e [args...]`\n\nRuns `.ts` file scripts.\n\n**Arguments**\n- `\u003ccommand\u003e` - script/command to run.\n- `[args...]` - arguments passed to the script/command.\n\n**Options**\n|Option|Default|Description|\n|:--|:--|:--|\n|`--no-color`|off|disables output color|\n|`--debug`|false|enables debug logging|\n|`-c, --config \u003cconfig\u003e`|[default](#default-typescript-config)|path to typescript configuration file|\n\n## Programmatic\nYou can require Just runner programmatically two ways:\n\nImport Just as early as possible in your application code.\n```JS\nrequire('@sonnyt/just/register');\n```\n\nOr you can use the `--require` (`-r`) [command line option](https://nodejs.org/api/cli.html#-r---require-module) to preload Just. By doing this, you do not need to require and load Just in your application code.\n\n```shell\nnode -r @sonnyt/just/register myscript.ts\n```\n\nPlease note that runner does not support type checking.\n\n## Default Config File\nJust automatically finds and loads `tsconfig.json` or `jsconfig.json`. By default, this search is performed relative to the entrypoint script. If neither file is found nor the file is not provided as an argument. Just falls back to using default settings shown below.\n\n```JSON\n{\n  \"compilerOptions\": {\n    \"module\": \"CommonJS\",\n    \"target\": \"ES2021\",\n    \"moduleResolution\": \"Node\",\n    \"inlineSourceMap\": true,\n    \"strict\": true,\n    \"baseUrl\": \"./\",\n    \"experimentalDecorators\": true,\n    \"emitDecoratorMetadata\": true,\n    \"esModuleInterop\": true,\n    \"skipLibCheck\": true,\n    \"importHelpers\": true,\n    \"outDir\": \"dist\",\n    \"paths\": {}\n  },\n  \"include\": [\n    \"./\"\n  ],\n  \"exclude\": [\n    \"node_modules\"\n  ]\n}\n```\n\n## Environment Variables\nWhen using the [dev](#dev) or [run](#run) commands. Just automatically finds and loads environment variables from a `.env` file into `process.env`. By default, this search is performed relative to the entrypoint script.\n\n## Path Alias\nBased on the `paths` [configuration](https://www.typescriptlang.org/tsconfig#paths), Just replaces all alias paths with relative paths after typescript compilation.\n\n## FAQ\n### Does Just work with ES Modules?\nCurrently, Just only supports building ES Module files.\n\n### What's the REPL use case?\nJust REPL enables you to execute TypeScript files on Node.js directly without precompiling. It serves as a replacement for [ts-node](https://www.npmjs.com/package/ts-node).\n\n### Does Just compile alias paths?\nOut of the box, Just supports build and runtime path aliases. All output file alias imports are replaced with relative paths.\n\n### What happens to my non-JavaScript/TypeScript files?\nIf your source directory includes non-compilable files (i.e., JSON, SVG, etc.), Just automatically copies them into your output directory.\n\n### How can I help?\nIf you would like to contribute, please see the issues labeled as [help-wanted](https://github.com/sonnyt/just/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22).\n\n## Roadmap\n- Build watch option [#7](https://github.com/sonnyt/just/issues/7)\n- Init option - copy over the default config file to the working directory [#5](https://github.com/sonnyt/just/issues/5)\n- [TypeScript ESLint](https://typescript-eslint.io/) support [#6](https://github.com/sonnyt/just/issues/6)\n- [Prettier](https://www.npmjs.com/package/prettier-eslint) support\n- REPL ES module support\n- ~~`jsconfig.json` support~~\n- `.swcrc` support\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsonnyt%2Fjust","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsonnyt%2Fjust","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsonnyt%2Fjust/lists"}