Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

create-foss-files

msaaddev23MIT1.1.1

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

open source, foss, open source files, license, code of conduct, editor configs, open source project, javascript, free and open source software, Saad Irfan, msaaddev

readme

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

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