Skip to content
/ starter Public template

🏁 Deno starter repository with CI, releases, and more

License

Notifications You must be signed in to change notification settings

denorg/starter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

28 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🏁 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"
  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

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