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

underscores

v0.0.2

Published

A command line utility for generating your Underscores (_s) based Wordpress starter theme.

Downloads

13

Readme

#underscores

underscores is a command line utility for generating and downloading your Underscores (_s) based Wordpress starter theme.

What it does

This tool acts as a shortcut for the form found on http://underscores.me that customizes and downloads a starter Underscores theme. This tool calls the same endpoint as the form on the website so the results should be the same.

The utility asks for user input and then downloads and unzips the customizes Underscores theme. Optionally, you may choose to save the downloaded zip file.

##Installation Installation is super simple through NPM. Here we install globally so you can use it anywhere:

npm install -g underscores

Usage

Typically you would run the command from within your wp-content/themes/ directory of your Wordpress installation.

Basic Usage

Simply running the underscores command by itself will walk you through a series of questions and then download the theme.

Advanced Usage

You may also supply all of the options that are collected in the basic method through command line parameters.

Full example:

This example demonstrates defining all of the parameters at the command line.

underscores -n "My Great Theme" -d "Great theme like you've never seen before" -g "my-great-theme" -a "Keith Morris <[email protected]>" -u "http:www.example.com" -s -k

From the --help command

Run underscores without command line arguments and you will be prompted for all options. Otherwise, run underscores with arguments to specify one or more options at the command prompt.

Examples:
  underscores                        you will be prompted for everything
  underscores -n "My Great Theme"    You will be prompted for everything but the name of the theme.


Options:
  --name, -n         The name of your theme.                                                 
  --description, -d  The theme's description.                                                
  --slug, -g         The theme's Wordpress slug (this also defines resultant directory name).
  --author, -a       Your theme's author.                                                    
  --url, -u          Your theme's author's url                                               
  --sass, -s         Download the "Sassified" version of the theme.                          
  --keep, -k         Keep the downloaded zip file after extraction                           
  --help, -h         Show this help message
  

Additional Uses

If used in conjunction with the getwordpress module, you can very easliy download wordpress and install an underscores theme:

getwordpress && cd wp-content/themes && underscores -n "Great Theme"