StartEase ⚡️

StartEase is a command-line interface (CLI) tool designed to make project setup a breeze. Whether you're working with your favorite technologies or exploring new ones, StartEase is your companion for quickly and effortlessly scaffolding projects.

Sponsors

We would like to thank our amazing sponsors for their support:

Cody	JetBrains	Adaptable

Features

• Effortless Scaffolding: StartEase streamlines project creation and technology scaffolding, providing a smooth and efficient experience for developers.

• Tech Stack Freedom: With StartEase, you have the freedom to choose and set up projects with your preferred technologies.

Installation 💿

You can install StartEase using either npm or yarn. Choose your preferred package manager:

Using npm:

npm install -g startease-cli

Using yarn:

yarn global add startease-cli

Usage 🚦

To start using StartEase, run the following command in your terminal:

startease-cli

This command will launch StartEase and guide you through the project setup process with easy-to-follow prompts.

That's it! StartEase simplifies project setup so you can focus on your development tasks.

Available Templates

The following project templates are available:

• Frontend:

  • [x] React App (Javascript / TypeScript)
  • [ ] Vue.js App
  • [ ] Angular App
  • [x] HTML/CSS/JavaScript Template

• Backend:

  • [x] Express.js Server
  • [x] Nest.js Server
  • [x] Django Web App
  • [ ] Ruby on Rails API
  • [ ] Flask API

• Full Stack:

  • [ ] MERN Stack App
  • [ ] MEAN Stack App
  • [ ] Django + React App
  • [ ] Ruby on Rails + Vue.js App

Supported Databases

The Project Starter Tool supports the following databases:

• [ ] PostgreSQL
• [ ] MySQL
• [x] MongoDB
• [x] SQLite

Contribution Guidelines

We appreciate your interest in contributing to our project. Whether you want to report a bug, suggest an enhancement, or contribute code, these guidelines will help you get started.

Table of Contents

1. How Can I Contribute?
   • Reporting Bugs
   • Suggesting Enhancements
   • Contributing Code
2. Getting Started
   • Forking the Repository
   • Setting Up Your Development Environment
   • Making Changes
   • Running Tests
   • Creating Pull Requests
3. License

How Can I Contribute?

Reporting Bugs

If you encounter a bug or unexpected behavior in StartEase, please open an issue and provide the following information:

• A clear and descriptive title.
• A detailed description of the bug, including steps to reproduce it.
• Information about your environment (e.g., operating system, Node.js version).
• Any relevant screenshots or error messages.

Suggesting Enhancements

We welcome suggestions for new features or improvements. To suggest an enhancement, open an issue with the following details:

• A clear and concise title.
• A detailed description of the enhancement or feature request.
• Any relevant context or examples that help explain the suggestion.

Contributing Code

We appreciate contributions that enhance StartEase. To contribute code:

1. Fork the repository.
2. Create a branch for your changes.
3. Make your code changes and commit them with clear messages.
4. Submit a pull request (PR).

Getting Started

Forking the Repository

Click the "Fork" button at the top-right of the StartEase repository to create a copy of the repository in your GitHub account.

Setting Up Your Development Environment

1. Clone your forked repository to your local machine:

   git clone https://github.com/JC-Coder/startease.git

2. Change to the project directory:

   cd startease

3. Install project dependencies:

   npm install

   or

   yarn install

Making Changes

1. Create a new branch for your changes:

   git checkout -b my-feature-branch

Running Tests

Before submitting your changes, test your changes to ensure it's working as expected. and also test other features to ensure nothing breaks.

Creating Pull Requests

When you're ready to submit your changes:

1. Commit your changes with a descriptive commit message.

2. Push your changes to your forked repository:

   git push origin my-feature-branch

3. Visit the StartEase repository on GitHub.

4. Click the "New Pull Request" button and follow the prompts.

We'll review your pull request as soon as possible.

Note: Pull requests are to be made against the dev branch.

License

By contributing to StartEase, you agree that your contributions will be licensed under the MIT License.