Detalhes do pacote

create-foss-files

msaaddev27MIT1.1.1

Get all the files you need for an open-source project

open source, foss, open source files, license

readme (leia-me)

cover

version license downloads

Confused about which files you should have in your open-source project!? Well, I built this tool to help you just with this confusion. With a single command, you get all the files which you should have in you project.

split

  • Simple: Extremely simple to use.
  • Cross-platform: Works on macOS, linux, and Windows.
  • JavaScript files: Generates additional files if you are developing a JavaScript project.
  • Prettier: Integrated prettier if the project is a JavaScript project.
  • MIT Licensed: Free to use for personal and commercial use.

📦 Installation

# install the CLI globally
npm install -g create-foss-files

# use it with npx (recommended)
npx create-foss-files --flag

🚀 Usage

Create a new project folder. Navigate into it. Run any of the following command inside of it.

# if installed globally (only generates required files)
cff

# if installed globally (add JavaScript files)
cff --javascript

# with npx (only generates required files)
npx create-foss-files

# with npx (add JavaScript files)
npx create-foss-files --javascript

🏗 Directory Structure

Directory tree with cff

└── [project name]
    ├── .editorconfig
    ├── .gitattributes
    ├── .gitignore
    ├── changelog.md
    ├── code-of-conduct.md
    ├── contributing.md
    ├── license
    └── readme

Directory tree with cff --javascript

└── [project name]
    ├── .editorconfig
    ├── .gitattributes
    ├── .gitignore
    ├── .npmrc
    ├── .prettierrc.json
    ├── changelog.md
    ├── code-of-conduct.md
    ├── contributing.md
    ├── index.js
    ├── license
    ├── package.json
    └── readme

👨🏻‍💻 Contributing

Make sure you read the contributing guidelines before opening a PR.

🔑 License & Conduct

changelog (log de mudanças)

Changes across different version of create-foss-files

v1.0.0

  • Initialize an empty git repository.
  • Generates the following files
    • .editorconfig
    • .gitattributes
    • .gitignore
    • changelog file
    • contributing guidelines file
    • readme file
    • MIT license
    • Code of Conduct
  • If used with --javascript flag, generates these additional files:
    • .npmrc
    • .prettierrc.json
    • index.js
    • package.json