create-electron-next-app

A full-featured project generator that creates a complete Electron + Next.js + TypeScript + Tailwind + gRPC desktop application — with clean architecture, typed IPC, preload isolation, Jest tests, CLI integration and production packaging via electron-builder.

This script automatically sets up everything you need to build a modern desktop application with a web-based renderer and a strongly typed backend.

---

🚀 Features

🔌 Full Electron Setup

• Isolated preload bridge (contextIsolation + secure IPC)
• Main process structured with clean architecture
  • controllers
  • services
  • repositories
  • ipc modules
• Global shortcuts
• Integrated CLI (compiled and exported through package.json)

🌐 Next.js Renderer

• Next.js 14
• TypeScript
• TailwindCSS
• Automatic UI skeleton creation

🟦 TypeScript Everywhere

• Separate tsconfig for:
  • main
  • preload
  • renderer
  • cli
  • grpc
• Typed IPC channels via shared types

🛰 gRPC Local Server

• Full gRPC server & client (echo example)
• Runs inside Electron main process or standalone
• Proto file included

🧪 Jest Test Suite

• Unit tests for FileService
• Integration test for gRPC

📦 Packaging

• electron-builder config (mac / win / linux)
• Auto-created dist installers

---

📦 Requirements

• pnpm
• Zsh
• Node 18+
• macOS / Linux / WSL (Windows compatible with Git Bash)

---

🛠 Installation

Clone the repository:

git clone https://github.com/yourname/create-electron-next-app
cd create-electron-next-app