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

Package detail

mernfinity

thejaAshwin62220MIT2.0.8TypeScript support: included

A simple CLI tool to build and deploy MERN stack projects

mern, deploy, nodejs, react, fullstack, devops, deployment, CI/CD, automation, build-tools, serverless, express, frontend, backend, typescript, javascript, web-app, api, web-development, render, frontend-framework

readme

Mernfinity

MERNfinity 🚀

NPM Version License Weekly Downloads

🚀 Supercharge your MERN development! From local build to cloud deploy - automate your workflow with just a few keystrokes. Say goodbye to deployment hassles, hello to DevOps magic! ✨

What is MERNfinity?

MERNfinity is your one-stop solution for handling the common tasks in MERN stack development:

  • Building your React frontend
  • Managing GitHub repositories
  • Deploying to Render
  • All of these with just a few clicks!

Quick Start 🏃‍♂️

npm install -g mernfinity

Then just run:

npm run setup

Features ✨

1. Smart Project Detection

  • Automatically finds your React frontend
  • Identifies your project structure
  • No complex configuration needed

2. Easy Deployment Options

Choose from these simple actions:

🔨 Build Frontend Only

  • Compiles your React application
  • Moves built files to the right place
  • Perfect for testing your build

🔄 Build & Push to GitHub

  • Builds your frontend
  • Handles Git initialization
  • Pushes to your GitHub repository

🚀 Full Deployment

  • Builds frontend
  • Pushes to GitHub
  • Deploys to Render
  • All in one go!

☁️ Deploy to Render

  • Sets up your Render configuration
  • Handles environment variables
  • Gets your app live quickly

📤 Push to GitHub

  • Smart Git repository handling
  • Remembers your preferences
  • Makes version control easy

✨ Spotlight Feature: One-Click GitHub Magic ✨

Tired of the endless git add, git commit, git push dance? MERNfinity's got you covered!

🎯 Smart GitHub Integration

Transform your deployment workflow with our intelligent GitHub push:

🧙‍♂️ Zero-Config Magic

  • First-time setup? We handle it automatically
  • Git configuration? We've got it covered
  • .gitignore? Generated instantly

🧠 Smart Memory

  • Remembers your preferred repositories
  • Saves your branch preferences
  • Keeps track of your deployment history

Lightning-Fast Workflow

  1. Select "Push to GitHub"
  2. Choose your repository (new or existing)
  3. Watch the magic happen!

🎨 Flexible Options

  • Create new repositories on the fly
  • Connect to existing projects
  • Switch branches seamlessly
  • Perfect for teams and solo developers

Why You'll Love It

  • 🚀 Deploy in seconds, not minutes
  • 🔄 Perfect for rapid iterations
  • 🛡️ Built-in safety checks
  • 🎯 No more command line hassles
  • 🌟 Ideal for beginners and pros alike

Just one click, and your code is safely on GitHub. It's that simple!

How It Works 🛠️

  1. Project Setup

    • Detects your project structure automatically
    • Lets you customize paths if needed
  2. Building

    • Installs dependencies
    • Builds your React app
    • Moves files to the right place
  3. Deployment

    • Handles Git operations
    • Creates Render configuration
    • Sets up continuous deployment

Project Structure 📁

A typical MERN project structure:

your-project/
├── client/              # Your React frontend
│   ├── src/
│   └── package.json
├── public/             # Built files go here
└── server files...     # Your backend files

Requirements 📋

  • Node.js 14+
  • npm 6+
  • Git installed
  • GitHub account (for GitHub features)
  • Render account (for deployment features)

Common Questions ❓

Q: Where does it build my files?

A: By default, it looks for a 'client' folder and builds to 'public'. You can customize these paths.

Q: Do I need a GitHub account?

A: Only if you want to use the GitHub features. You can still use build-only features without it.

Q: Is the GitHub push feature secure?

A: Absolutely! We use your local Git configuration and GitHub CLI for secure authentication.

Q: What if I'm new to Git?

A: Don't worry! Our smart setup wizard will guide you through the entire process.

Support & Contributing 🤝

For help and updates:

License

MIT License - feel free to use in your projects!