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

ollie-cli

v1.1.4

Published

Project boilerplate servant

Downloads

5

Readme

Ollie project generator

A project generation helper for web, android and ios projects.

npm version Dependencies

Usage

Ollie is as simple as calling him in your terminal.

ollie

Ollie will guide you through the generation of your new project by asking questions about what project type, your bitbucket credentials, your team, ...

Installation

Install the binary to make ollie availlable in your cli.

Install via npm

npm install --global ollie-cli

or via yarn

yarn global add ollie-cli

To push a project to Bitbucket, be sure to add your machine's ssh key to your Bitbucket account.

Boilerplates

A boilerplate can be of any language and framework type. Ollie knows predefined boileplates but don't feel held back to create your own boilerplate.

In need of special variable parts inside your boilerplate? ollie.yml can help with that!

ollie.yml

Ollie can ask questions specific for your boilerplate. You can define theses questions in a file ollie.yml. An example:

replacementQuestions:
  - name: NAME
    message: Some name
  - name:   DESCRIPTION
    message: Describing the project
  - name: AUTHOR_EMAIL
    message: Author email address

Development

This repository is only meant for development. If you are only interested in using Ollie, install him through npm as explained in installation.

When developing, you should ensure all npm modules are installed: npm install.

These are all useful scripts for development:

# spin up ollie running your local code
$ npm start

# build and spin up ollie running your local code
$ npm serve

# lint the local
$ npm run lint

# run all tests
$ npm test

Concepts

Two important concepts are Surveys and Questions.

Surveys

Surveys are responsible for composing questions in the correct order. Depending on the answers given, either complentary questions are asked or actions are executed. E.g.

  • A survey asks what project type (Web, iOS, Android) you want to create. If e.g. the answer is 'Web', we should ask a second question to know what type of web project is wanted.
  • A survey asks the project name + Bitbucket credentials. With these answers the repository can be pushed to Bitbucket's remote.

Questions

Questions must always return question objects (or an array of objects). These question objects must following the Inquirer questions API.

Security

Because we use 2 factor authentication we need to create an application password for github and bitbucket. You will be prompted for this password after selecting the "Which service do you wish to use?" [Bitbucket/Github]

Setup

Github

Click here to generate a token

Click 'Generate new token'

Give the app password a name and Full control of private repositories.

Bitbucket

Click here to create an app password

Click 'create app password'

Give the app password a name and add the following permission:

  • Read/Write on Projects
  • Admin on Repositories

Considerations

The app password will be used to create the repo, but your local ssh key will be used to pull and push the repo. You will be prompted to save your credentials in a config file. At all time you can edit or remove the config file ($HOME/.ollieconfig)

code flow

Bugs

When you find issues, please report them:

https://github.com/icapps/ollie/issues

Be sure to include all of the output from the npm command that didn't work as expected. The npm-debug.log file is also helpful to provide.

Authors

See the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE.md file for details