create-foss-files

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

Usage no npm install needed!

<script type="module">
  import createFossFiles from 'https://cdn.skypack.dev/create-foss-files';
</script>

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