npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

initium

v0.8.4

Published

A single static binary that can run on any CI to build your code and deploy it in a single step.

Downloads

5

Readme

Initium project CLI

A single static binary that can run on any CI to build your code and deploy it in a single step.

All with a nice development workflow in mind like ephemeral environment for your PRs.

Running the CLI

The CLI is currently published on NPM. You can run it using

npx initium

That will install the Initium CLI in your folder's node_modules.

We recommend you not to try installing the CLI globally if you don't use a Node.js version manager (like nvm), as you can run into permission errors.

Pre-requisites

  1. GoLang

    You can install it with your prefered package manager or usign asfd with asdf install.

  2. Docker (or similar solutions)

    Here you can find a list of possible candidates:

Build the executable

In order to build the executable you simply need to run

make build

You will be able to run the executable from

./bin/initium

Setup local environment

These are the environment variables that you have to set in order to use the onmain, onbranch commands from your local environment

export INITIUM_REGISTRY_PASSWORD="<github_pat>"
export INITIUM_REGISTRY_USER="<github_user>"

and

export INITIUM_CLUSTER_ENDPOINT=$(kubectl config view -o jsonpath='{.clusters[?(@.name == "kind-initium-platform")].cluster.server}')
export INITIUM_CLUSTER_TOKEN=$(kubectl get secrets initium-cli-token -o jsonpath="{.data.token}" | base64 -d)
export INITIUM_CLUSTER_CA_CERT=$(kubectl get secrets initium-cli-token -o jsonpath="{.data.ca\.crt}" | base64 -d)

Supported Application Runtimes

Following we have a matrix related to which application runtime our CLI is currently compatible with. For each one of them a Dockerfile template is being used in order to provide an easy way to build and deploy the application to a Kubernetes cluster.

| Application Runtimes | Supported | |----------------------|:------------------:| | Nodejs | :white_check_mark: | | GoLang | :white_check_mark: | | Python | Coming Soon | | More will be added...| |

CI Integrations

The matrix below gives an overview of the integration status of our CLI with CI platforms. CLI is able to create automatically build and deploy pipelines in order to enable CICD process for the application it is used with. Related template files are being used to cover different process steps.

| CI Systems | Supported | |----------------------|:------------------:| | GitHub Actions | :white_check_mark: | | Gitlab CI | Coming Soon | | Azure Devops | Coming Soon | | More will be added...| |

Encrypt your secret with:

./initium secrets encrypt --publicKey age1zmh77nlvddsz55q5l67d4ufwewvyhentlku9z90t969szd2lnghslnlese --secret <your secret>

or if it's not a string

./initium secrets encrypt --publicKey age1zmh77nlvddsz55q5l67d4ufwewvyhentlku9z90t969szd2lnghslnlese --base64secret <your secret in base64>