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 🙏

© 2025 – Pkg Stats / Ryan Hefner

plano-dev-21-dias

v1.0.0

Published

Projeto exemplo que imprime Olá, Mundo!

Downloads

24

Readme

Plano-Dev

Repositório de exemplo do treino Plano Dev — coleção de mini-projetos para aprender HTML, CSS e JavaScript.

Mini-Projeto: List App

O projeto principal deste repositório é o "List App" — uma aplicação simples de lista de tarefas para aprender manipulação de arrays, DOM e integração com Node.js.

Como executar

  • Backend (terminal):
npm run list
# Ou:
node list-backend.js
  • Frontend (navegador):
npm run list:web
# Ou: abrir list-index.html no navegador

Arquivos principais

  • list-index.html — Frontend (HTML)
  • list-style.css — Estilos (CSS)
  • list-script.js — Lógica Frontend (JavaScript)
  • list-backend.js — Backend em Node.js (exemplo CLI)

Objetivo

  • Demonstrar integração entre HTML/CSS/JavaScript e Node.js com exemplos práticos e exercícios de arrays.

Se você quiser mais instruções ou o histórico detalhado do projeto, confira o arquivo LIST_APP_GUIA.md.


Mini-Projeto: Validador de E-mail (CLI)

Um projeto prático do Plano Dev de 21 Dias, criado para treinar manipulação de strings, regex, validações e construção de um CLI profissional usando Node.js.

Sobre o Projeto 🔥

Este CLI permite validar e-mails diretamente pelo terminal, oferecendo modo padrão, modo estrito, além de opções como --verbose e --silent. É um projeto simples, mas muito poderoso para treinar:

  • Regex
  • CLI com Node
  • Manipulação de argumentos
  • Modularização
  • Empacotamento com pkg (gerando .EXE)

Funcionalidades 📦

✔ Validação padrão ✔ Validação estrita ✔ Modo silencioso (retorna apenas status 0/1) ✔ Modo verbose (detalhes técnicos da validação) ✔ Ajuda com exemplos ✔ Banner ASCII estilizado ✔ Versão empacotada em .exe

Como executar 🚀

1. Executar via Node.js
```bash
node validarEmail.cli.js [email protected]
´´´

2. Modo Estrito
```bash
node validarEmail.cli.js --strict [email protected]
´´´

3. Modo Verbose
```bash
node validarEmail.cli.js --verbose [email protected]
´´´

4. Modo Silencioso
```bash
Retorna 0 para válido e 1 para inválido.
´´´

```bash
node validarEmail.cli.js --silent [email protected]
echo $?
´´´

Usando via comando global (npm link) 🖥️

Se quiser rodar com o comando direto validar-email:

npm link
´´´

Depois:

validar-email [email protected]
´´´

Gerando o Executável (.EXE) 🏗️

npm run build:exe
´´´

O executável será criado dentro da pasta:

dist/

Execute assim:

./dist/validarEmail.cli.exe [email protected]
´´´

🧪 Exemplos de Saída ✔ E-mail válido ╔═══════════════════════════════════╗ ║ VALIDADOR DE E-MAIL – CLI ║ ╚═══════════════════════════════════╝ ✔ E-mail válido! "[email protected]" passou na validação (padrão).

✖ E-mail inválido ✖ E-mail inválido. "teste@com" não atende ao padrão (estrito).

O que aprendi com este projeto 📚

  • Criar e organizar funções de validação
  • Trabalhar com regex simples e avançada
  • Criar um CLI real com Node.js
  • Tratar argumentos e flags
  • Criar um executável com pkg
  • Melhorar experiência do usuário com banner e mensagens coloridas
  • Publicar scripts no package.json

Próximos passos do aprendizado 💡

  • Publicar o pacote no npm
  • Criar testes automatizados (Jest)
  • Criar validações adicionais (telefone, CPF, etc.)

Autor 👨‍💻

Vagner Vieira da Silva Desenvolvedor em evolução no Plano Dev de 21 Dias – DevClub