Skip to content

Haresh-729/quikFrontend

Repository files navigation

quikfrontend CLI 🚀

quikfrontend is a powerful and intuitive CLI tool that simplifies the process of setting up modern frontend projects. With a single command, generate a fully configured React project using Vite, pre-loaded with Tailwind CSS, React Router, Redux Toolkit, and more. Say goodbye to repetitive boilerplate setup and hello to rapid development! 🎉


✨ Features

  • Instant Project Setup: Create a production-ready React project with Vite in seconds.
  • Pre-Configured Stack:
    • Tailwind CSS for styling.
    • React Router for navigation.
    • Redux Toolkit for state management.
    • Axios for API calls.
    • Lucide React for icons.
    • Google OAuth for authentication.
  • Modern Folder Structure: Organized components, services, and utilities.
  • Customizable: Easily extend or modify the generated project to fit your needs.
  • Developer-Friendly: Modular codebase with clear documentation.

🛠️ Installation

Get started with quikfrontend in just a few steps:

  1. Install globally via npm:

    npm install -g quikfrontend
  2. Run the CLI:

    quikfrontend

Alternatively, use npx to run without installing globally:

npx quikfrontend

🚀 Usage

Run the quikfrontend command and follow the interactive prompts to configure your project:

quikfrontend

Example Prompts

? Select a framework: React
? Select a language: JavaScript
? Enter project name: my-awesome-app

This will:

  • Create a new Vite-based React project named my-awesome-app.
  • Set up a Frontend folder with a pre-configured structure.
  • Install dependencies like Tailwind CSS, React Router, and Redux Toolkit.
  • Generate essential files (e.g., RoutesConfig.jsx, DashboardSlice.js).
  • Start the development server automatically.

Generated Project Structure

Frontend/
├── src/
│   ├── app/
│   │   ├── DashboardSlice.js
│   │   └── store.js
│   ├── components/
│   │   ├── common/
│   │   ├── protected/
│   │   ├── utils/
│   │   └── data/
│   ├── services/
│   │   ├── repository/
│   │   ├── Apis.js
│   │   └── Connector.js
│   ├── index.css
│   ├── App.jsx
│   ├── main.jsx
│   └── RoutesConfig.jsx
├── .env
├── vite.config.js
└── package.json

📋 Prerequisites

  • Node.js: Version 16.x or higher.
  • npm: Version 8.x or higher.
  • A valid Google Client ID for OAuth integration (add to .env).

⚙️ Configuration

The generated project includes a .env file for environment variables. Update it with your API base URL and Google Client ID:

VITE_API_BASE_URL=http://localhost:3000
VITE_PUBLIC_GOOGLE_CLIENT=your-google-client-id

Note: Keep the .env file secure and never commit it to version control.


🧑‍💻 Contributing

We welcome contributions to make quikfrontend even better! Here's how to get started:

  1. Fork the repository.

  2. Clone your fork:

    git clone https://github.com/Haresh-729/quikFrontend
  3. Install dependencies:

    cd quikfrontend
    npm install
  4. Create a new branch:

    git checkout -b feature/your-feature
  5. Make your changes and commit:

    git commit -m "Add your feature"
  6. Push to your fork:

    git push origin feature/your-feature
  7. Open a Pull Request on GitHub.

Please read our Contributing Guidelines for more details.


🐛 Reporting Issues

Found a bug? Have a feature request? Open an issue on our GitHub Issues page.


📜 License

quikFrontend CLI by Haresh Kurade is licensed under CC BY-NC 4.0 Creative Commons Attribution NonCommercial


🌟 Acknowledgements

  • Built with ❤️ by Haresh Kurade.
  • Inspired by modern frontend development workflows.
  • Thanks to the open-source community for tools like Vite, React, and Tailwind CSS.

📬 Contact

Have questions or feedback? Reach out to us:


Start building your next frontend project with ease! 🚀

About

quikFrontend is a powerful and intuitive CLI tool that simplifies the process of setting up modern frontend projects.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •