davidgs

npx-card

$ npx davidgs

Generate your own npx <your_username> card easily with provided configurations. 😃 Fork & get started and leave a star ⭐ to this repo

NOTE: Do not install this package as a global package i.e. npm -g davidgs. Always use npx davidgs to view the card as this package won't be used as any other command

---

available scripts

• build: to build the output (entry point for the script: src/index.js)
• view: to view the output (entry point for the script: src/card.js)
• prepublish: runs before the npm publish command to generate the build

---

files:

file name	path	usage
index.js	src/	entry point file / to generate the output
card.js	src/	to read the output
boxen.config.js	src/config/	boxen color, bgColor, style, etc configuration
chalk.config.js	src/config/	chalk configuration for various methods
io.config.js	src/config/	io provide the path of output file
boxUI.js	src/user/	boxen js user defined UI options
data.js	src/user/	user data with configuration
createConsoleString.js	src/utils/	creates the console string which need to be saved as output
io.js	src/utils/	to read and write the file to the output location
output	bin/	output file which needs to be displayed

---

config files:

• boxen.config.js: provides the various colors, styles, text aligns and box styles parameters.
  • exports: This file exports four objects:
    • BOXEN_COLOR: BLACK, RED, GREEN, etc...
    • BORDER_STYLE: TOPLEFT, TOP, TOPRIGHT, RIGHT, BOTTOMRIGHT, BOTTOM, BOTTOMLEFT, LEFT
    • TEXTALIGN: LEFT, RIGHT, CENTER
    • BOX_STYLE: SINGLE, DOUBLE, ROUND, BOLD, SINGLEDOUBLE, DOUBLESINGLE, CLASSIC, ARROW
  • usage: for complete usage and for more example please visit BoxenJS

  import {
    BOXEN_COLOR,
    BORDER_STYLE,
    TEXTALIGN,
    BOX_STYLE
  } from './config/boxen.config.js' // use relative path here to your file
  
  // use these while creating boxUI.js or while using boxen() method
  
  BOXEN_COLOR.RED     // to provide color to the box
  BOXEN_STYLE.ROUND   // to provide border style to the box
  TEXTALIGN.RIGHT     // to provide the text align in the box
  BORDER_STYLE.TOP    // to provide custom deign to the box

• chalk.config.js: It provides colors, background colors, Modifiers and color methods for custom color.
  • exports: This file exports four objects
    • COLORS: colors methods
    • BGCOLORS: background color methods
    • MODIFIERS: style modifiers for the text
    • COLORMETHODS: methods to provide the custom colors / user defined colors
  • usages: for complete usage and for more example please visit ChalkJS

  import {
    COLORS,
    BGCOLORS,
    MODIFIERS,
    COLORMETHODS
  } from './config/chalk.config.js'; // use relative path here to your file
  
  // use these methods in data.js file or with chalk library
  COLORS.blue         // provide color to the text
  BGCOLORS.white      // provide background color to the text
  MODIFIERS.bold      // provide styles to the text
  COLORMETHODS.rgb    // use method to provide custom colors for both text color and text background color

• io.config.js: provide the __dirname functionality to the ES modules to generate output correctly

---

How to publish your own card:

• fork/clone this repo
• change the data in src/user/data.js file
• login to your npm account using npm login
• publish this to npm using npm publish
• udpate the package version using below commands
  • patch: npm version patch to update last version number v1.0.1
  • minor: npm version minor to update middle version number v1.1.0
  • major: npm version major to update the first version number v2.0.0

---

License

MIT Copyright (c) 2023 David G. Simmons (davidgs)