{"id":15548448,"url":"https://github.com/mongodben/jurassic-park","last_synced_at":"2025-11-12T02:22:37.561Z","repository":{"id":116503383,"uuid":"467986195","full_name":"mongodben/jurassic-park","owner":"mongodben","description":"snooty to docusaurus converter ","archived":false,"fork":false,"pushed_at":"2022-03-11T02:50:51.000Z","size":264,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-31T02:44:23.417Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/mongodben.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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}},"created_at":"2022-03-09T15:34:02.000Z","updated_at":"2023-03-04T03:35:31.000Z","dependencies_parsed_at":null,"dependency_job_id":"d06ecf7f-254d-48c6-9643-5b772907a41b","html_url":"https://github.com/mongodben/jurassic-park","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":"bscotch/typescript-template","purl":"pkg:github/mongodben/jurassic-park","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mongodben%2Fjurassic-park","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mongodben%2Fjurassic-park/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mongodben%2Fjurassic-park/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mongodben%2Fjurassic-park/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mongodben","download_url":"https://codeload.github.com/mongodben/jurassic-park/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mongodben%2Fjurassic-park/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":283962104,"owners_count":26923739,"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","status":"online","status_checked_at":"2025-11-12T02:00:06.336Z","response_time":59,"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":[],"created_at":"2024-10-02T13:21:38.015Z","updated_at":"2025-11-12T02:22:37.540Z","avatar_url":"https://github.com/mongodben.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Typescript Template (Typescript Starter Project) for Node Modules and CLIs\n\n- 🚀 Start coding immediately, without worrying about configuration\n- 📰 Publish your package to NPM with only a few tweaks\n- 🧹 Use a tidy file structure that is already set up for dev\n- 🧪 Test suite ready to fill out\n- 💻 Deliver a Command Line Interface version of your project\n- ✨ Auto-format your code with Prettier\n- 🔬 Find issues with ESLint\n- ⚡ Includes Visual Studio Code extension recommendations and default settings, for maximum productivity out of the box\n\nGetting a Typescript project running\nis a pain, since there is a lot of environment and configuration setup\nbefore you can get started. If you want to be able to publish\nyour Typescript project to [npm](https://www.npmjs.com/) there is even more\nconfiguration to ensure that you are only (and definitely) pushing the files\nthat are strictly needed. Finally, setting up testing can be confusing,\nespecially since test code also needs to be compiled but should not be\nincluded with your published npm package.\n\nThis starter kit aims to alleviate all the annoyance of setting up a modern\nTypescript project for Node packages.\n\n## ⚠ Caveats ⚠\n\n- This template is for Node, not Browser, projects.\n- To support Node versions \u003c14 you may need to change the `tsconfig.json` target settings.\n\n## Setup Guide\n\n### Dependencies\n\n- [**Node.js v13.2+**](https://nodejs.org/) (v14+ highly recommended)\n\n### Preparing a new project\n\n#### The easy way: GitHub Templates\n\n[This project](https://github.com/bscotch/typescript-template) is set up as a GitHub template.\n\n1. Click the \"Use this Template\" button on the project homepage to create your own\n   remote repo with everything here. Follow the prompts.\n2. On your local machine, use GitHub Desktop to clone the repo, or\n   navigate to the parent folder where you want to keep your\n   local repo copy and run `git clone your-remote-url`.\n\n#### The hard way: All CLI, all the time\n\n1. Create a new remote repo on your host (e.g. GitHub, BitBucket, GitLab, etc.)\n1. Go to the local parent folder into which you want to put your new Typescript project\n   (via your file explorer or a terminal)\n1. Clone this repo locally: `git clone --branch develop git@github.com:bscotch/typescript-template.git`\n1. Rename the folder containing this repo (`typescript-template`) to your project's name\n1. Go to your new local repo (via a Git GUI or a terminal (with `cd your-new-name`))\n1. (Optional) If you don't want the git history from this template to be included in your project's history:\n1. Delete the `.git` folder\n1. Run `git init` (or use a Git GUI to initialize the repo)\n1. Change the remote to your own remote repository: `git remote set-url origin your-remote-url` (or, if you initialized a new repo, add your remote with `git remote add origin your-remote-url`)\n\n#### Customize the template\n\n1. Run `npm install` to install all dependencies\n2. (Optional) Run `npm outdated` to see if any dependencies have major updates.\n3. (Optional) Run `npm update` to get those dependencies up to date with minor updates.\n4. Update the `package.json` with your project's details\n   - Set the `name` field. If you are going to publish to npm, this will be the name of your package. Must be a URL-friendly name. Best practice is to use kebab-case (all lower-case, alphanumeric and dashes).\n   - Set the `description` field.\n   - Set the `repository` field to your remote git repo's URL.\n   - Set the `homepage` field (your remote git repo's URL works fine for this).\n   - Add any `keywords` strings. If you publish to npm, these will be used by searches.\n   - Remove the `private` field **if you want to publish to npm**.\n   - If you do not want to publish to npm, remove `\u0026\u0026 npm publish` from the `scripts.postversion` script.\n5. Check the `.gitignore` and add any filetypes or folders you want to keep out of your repo.\n6. Remove any stuff from the template that you don't care about. (You can do this at any time.)\n7. Open up the `./tsconfig.json` file to see if you want to change anything. Pay particular attention to the `paths` section!\n8. Commit all your changes: `git add -A; git commit`\n9. Push your commit: `git push`\n\n### Begin coding!\n\n- Your entrypoint is `./src/index.ts`, so start there!\n- Your compiled code will appear in a git-ignored `build` folder, with entrypoint `build/index.js`.\n- To compile, run `npm run build`\n- To auto-recompile while you code, run `npm run build-live`\n- Sample folders and files for types and your code library are placed in `src/lib` and `src/types`.\n- If you intend to use the `fs-extra` module for anything in your non-test code,\n  move it from the `devDependencies` to the `dependencies` section of your `package.json`.\n\n### Creating a CLI (Command Line Interface)\n\nThis template project comes with the [commander module](https://www.npmjs.com/package/commander),\nwhich is great for rapidly building command line interfaces\n(uninstall it with `npm uninstall commander` if you don't need to make a CLI).\n\nTo create a CLI that will become available when someone installs your npm package:\n\n- Rename `src/cli/cli.ts` to `src/cli/your-main-cli-name.ts`. This is the entrypoint\n  for your CLI.\n- Name any subcommand files to `src/cli/your-main-cli-name-subcommand.ts`.\n  Update the CLI entrypoint to use the same subcommand names.\n  Subcommand scripts _must_ start with the same name as your main CLI script,\n  and _must_ end with an exact command name listed by its parent script\n  (one of the `cli.command()` values).\n- Modify the CLI templates to do whatever it's all supposed to do.\n- To make `your-cli-command` available to users who install your\n  npm package, add the `bin` field to your `package.json`, like so:\n  ```jsonc\n  {\n    //... other root package.json options\n    \"bin\": {\n      \"your-cli-command\": \"build/cli/your-main-cli-name.js\"\n    }\n  }\n  ```\n\nTest your CLI locally by running `node build/cli/your-main-cli-name.js -h`.\n\nIf you publish your project as an npm module, users who install it will be able\nto run `npx your-cli-command` in their terminals, or simply `your-cli-command`\nif they've done a global install of your module (with `npm install --global your-module-name`).\n\n### Testing\n\n- Add tests to `./src/test` as you go.\n- Place any reference data for tests into `./samples`\n- Run tests from the terminal with `npm test` (make sure your code is compiled first).\n- Run tests from VSCode (click the debugger on the sidebar) to use breakpoints and allow inspection:\n  - Use the \"Tests\" option to run against your compiled code.\n  - Console logs will appear in the Debug Console, where you can also step through your code if you set breakpoints.\n  - Edit `./.vscode/launch.json` to add or change the tests.\n\n### Versioning and publishing to npm\n\nWhen you are ready to increment the version of your project, which by default\nis coupled to publishing to `npm` and merging into your `main` branch\n(edit this behavior in the `scripts` section of the `package.json`),\nuse the `npm version` commands. For example:\n\n- `npm version patch` to bump the patch version, indicated a bugfix\n- `npm version minor` to bump the minor version, indicating a new feature (backwards-compatible)\n- `npm version major` to bump the major version, indicating substantial and/or breaking changes\n\nThe `preversion`, `version`, and `postversion` scripts in the `package.json` file dictate what happens\nwhen you use an `npm version` command. By default, the sequence of things that happen are:\n\n1. Source is compiled into plain JavaScript.\n2. Tests are run against the compiled JavaScript. If any fail, the process aborts.\n3. Increment the version number in the `package.json` file.\n4. Update `CHANGELOG.md` to reflect the new version.\n5. `git add` all file changes.\n6. Commit changes and create a version tag.\n7. Push changes to remote\n8. Publish package to `npm`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmongodben%2Fjurassic-park","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmongodben%2Fjurassic-park","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmongodben%2Fjurassic-park/lists"}