Home

Awesome

🏁 Deno Starter

This is a starter template for building Deno packages in TypeScript, with GitHub Actions-powered CI, tests, CLI, and Semantic Release on GitHub and npm.

Deno CI GitHub Contributors Deno Starter Made by Denorg TypeScript semantic-release

💡 How to use

  1. Create a new repository using this template
  2. Update the project name ("Deno Starter") from the first line in README.md
  3. Find and replace "denorg/starter" with your "username/repository" in README.md
  4. Update the "Getting started" guide with your exported functions' names
  5. In .github/workflows/*.yml files, add additional permissions after deno test
  6. Setup Semantic Release
  1. Remove this section ("How to use") after setting up your respoitory

If you're not building a Denorg project, the following steps are required too:

  1. Remove the "A project by Denorg..." footer from README.md
  2. Remove the "Made by Denorg" shield from the README.md badges section
  3. Change the "Denorg" name to yours in LICENSE and under "License" in README.md

⭐ Getting started

Import the mode function and use it:

import { mode } from "https://raw.githubusercontent.com/denorg/starter/master/mod.ts";

const result = mode();

CLI with DPX

After installing DPX, you can directly use the CLI using the dpx command:

dpx --allow-read starter <arguments>

CLI

Alternatively, you can use it directly from the CLI by using deno run:

deno run --allow-read https://raw.githubusercontent.com/denorg/starter/master/cli.ts <arguments>

You can also install it globally using the following:

deno install --allow-read -n starter https://raw.githubusercontent.com/denorg/starter/master/cli.ts

Then, the package is available to run:

starter <arguments>

Configuration

Required permissions:

  1. --allow-read

👩‍💻 Development

Run tests:

deno test --allow-read

📄 License

MIT © Denorg

<p align="center"> <a href="https://den.org.in"> <img width="100" alt="" src="https://raw.githubusercontent.com/denorg/denorg/master/logo.svg"> </a> </p> <p align="center"> <sub>A project by <a href="https://den.org.in">Denorg</a>, the world's first Deno-focused community<br>organization and consulting company. <a href="https://den.org.in">Work with us →</a></sub> </p>