{"id":51527558,"url":"https://github.com/josefkuchar/typst-dl","last_synced_at":"2026-07-08T23:01:24.926Z","repository":{"id":353552138,"uuid":"1219907581","full_name":"JosefKuchar/typst-dl","owner":"JosefKuchar","description":"Download a Typst package from an HTTP(S) Git repository into Typst's local package directory.","archived":false,"fork":false,"pushed_at":"2026-04-24T11:40:03.000Z","size":30,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-24T12:33:52.527Z","etag":null,"topics":["download","downloader","git","package","package-manager","registry","toml","typst"],"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/JosefKuchar.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-24T10:45:08.000Z","updated_at":"2026-04-24T11:40:06.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/JosefKuchar/typst-dl","commit_stats":null,"previous_names":["josefkuchar/typst-download"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/JosefKuchar/typst-dl","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JosefKuchar%2Ftypst-dl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JosefKuchar%2Ftypst-dl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JosefKuchar%2Ftypst-dl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JosefKuchar%2Ftypst-dl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JosefKuchar","download_url":"https://codeload.github.com/JosefKuchar/typst-dl/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JosefKuchar%2Ftypst-dl/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35280682,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-08T02:00:06.796Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["download","downloader","git","package","package-manager","registry","toml","typst"],"created_at":"2026-07-08T23:01:23.058Z","updated_at":"2026-07-08T23:01:24.905Z","avatar_url":"https://github.com/JosefKuchar.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# typst-dl\n\n[![npm version](https://img.shields.io/npm/v/typst-dl)](https://www.npmjs.com/package/typst-dl)\n\nDownload a Typst package from an HTTP(S) Git repository into Typst's local package directory.\n\nTypst Universe packages are published by opening a pull request against\n`typst/packages`. `typst-dl` solves the pre-publish and out-of-tree case: install a\npackage directly from its Git repository while developing, testing, or using a\npackage that is not in Typst Universe yet.\n\n## Install\n\n```bash\nnpm install -g typst-dl\n```\n\nYou can also run it without installing:\n\n```bash\nnpx typst-dl \u003cgit-repository-url\u003e\n```\n\n## CLI usage\n\n```bash\nnpx typst-dl https://github.com/stuxf/basic-typst-resume-template\n```\n\nThe command prints the installed package identifier:\n\n```text\nInstalled @git/\u003cpackage-name\u003e:\u003cpackage-version\u003e\n```\n\nUse that identifier in your Typst file with `#import`:\n\n```typst\n#import \"@git/\u003cpackage-name\u003e:\u003cpackage-version\u003e\": *\n```\n\nFor example, a package whose `typst.toml` contains `name = \"my-package\"` and\n`version = \"1.0.0\"` can be imported as:\n\n```typst\n#import \"@git/my-package:1.0.0\": *\n```\n\n```text\ntypst-dl \u003cgit-repository-url\u003e [--namespace \u003cname\u003e] [--data-dir \u003cpath\u003e] [--force]\n```\n\nOptions:\n\n- `--namespace`, `-n`: override the namespace, defaults to `git`\n- `--data-dir`: override Typst's data directory\n- `--force`: replace an already installed `{namespace}/{name}/{version}`\n- `--help`, `-h`: print usage information\n\n## Behavior\n\n- Clones the repository with a shallow clone.\n- Reads `typst.toml` from the repository root.\n- Detects `package.name` and `package.version`.\n- Installs the package to:\n\n```text\n{data-dir}/typst/packages/{namespace}/{name}/{version}\n```\n\nDefault namespace: `git`\n\n`{data-dir}` is resolved the same way Typst does:\n\n- Linux: `$XDG_DATA_HOME` or `~/.local/share`\n- macOS: `~/Library/Application Support`\n- Windows: `%APPDATA%`\n\n## Notes\n\n- Currently supports HTTP(S) Git repository URLs.\n- Respects `package.exclude` from `typst.toml`.\n- Does not keep the cloned `.git` directory in the installed package.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjosefkuchar%2Ftypst-dl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjosefkuchar%2Ftypst-dl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjosefkuchar%2Ftypst-dl/lists"}