starter

🏁 Deno starter repository with GitHub Actions CI

View the Project on GitHub denorg/starter

🏁 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
    • Add a repository secret NPM_TOKEN with your npm token
    • In .github/workflows/deno.yml, find and replace “denorg/starter” with your “username/repository”
  7. 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

A project by Denorg, the world's first Deno-focused community
organization and consulting company. Work with us →