quick-next ⚡

Quick and customizable Next.js project scaffolding CLI tool

Next.js projeleri için hızlı ve özelleştirilebilir proje oluşturucu

English • Türkçe

English

🚀 Quick Start

Create a new Next.js project in seconds:

npx quick-next

📦 Installation

Global Installation (Optional)

npm install -g quick-next
quick-next

One-time Use with npx

npx quick-next

✨ Features

• ⚡ Lightning Fast - Create production-ready Next.js projects in seconds
• 🎨 shadcn/ui Integration - Beautiful, accessible components out of the box
• 📝 TypeScript/JavaScript - Choose your preferred language
• 🎯 App Router & Pages Router - Support for both Next.js routing systems
• 🎨 Multiple Styling Options - Tailwind CSS, CSS Modules, Styled Components, or plain CSS
• 📁 Customizable Structure - Choose exactly which folders you need
• 🌙 Dark Mode Ready - Built-in dark mode support with shadcn/ui
• ✨ ESLint & Prettier - Code quality and formatting tools
• 📦 Package Manager Choice - npm, yarn, pnpm, or bun support (New in v1.0.7!)
• 🔧 Environment Variables - Pre-configured .env files
• 🎯 Git Integration - Optional Git initialization with first commit
• 🇹🇷 Turkish Interface - Native Turkish language support
• 🔧 Zero Configuration - Works out of the box with sensible defaults
• 📚 Best Practices - Follows Next.js and React best practices

🎯 What You Get

Project Options

• Project Name - Custom folder name for your project
• TypeScript/JavaScript - Full TypeScript support or classic JavaScript
• src/ Directory - Optional src folder for better organization
• Router Type - Choose between App Router (recommended) or Pages Router
• Folder Structure - Select from:
  • components - React components
  • lib - Utility functions and helpers
  • hooks - Custom React hooks
  • styles - Style files
  • types - TypeScript type definitions
  • utils - Helper utilities
  • config - Configuration files
  • constants - App constants
  • context - React context providers
  • api - API helpers and services

Styling Solutions

• Tailwind CSS - Utility-first CSS framework (with optional shadcn/ui)
• CSS Modules - Scoped CSS with module system
• Styled Components - CSS-in-JS solution
• Plain CSS - Traditional CSS files

shadcn/ui Integration

When you select Tailwind CSS, you can optionally add shadcn/ui which includes:

• ✅ Automatic components.json configuration
• ✅ Pre-configured Tailwind theme with CSS variables
• ✅ Dark mode support out of the box
• ✅ cn() utility function for className merging
• ✅ Ready-to-use components/ui folder structure
• ✅ All necessary dependencies installed

After project creation, add components easily:

npx shadcn-ui@latest add button
npx shadcn-ui@latest add card
npx shadcn-ui@latest add dialog

Browse all components at ui.shadcn.com

📖 Usage Example

$ npx quick-next

🚀 Next.js Proje Oluşturucu

✔ Proje adı nedir? … my-awesome-app
✔ TypeScript kullanmak ister misin? › Evet
✔ src/ klasörü kullanmak ister misin? › Evet
✔ Hangi router yapısını kullanmak istersin? › App Router (önerilen)
✔ Hangi klasörleri eklemek istersin? › components, lib, hooks, utils
✔ Hangi styling çözümünü kullanacaksın? › Tailwind CSS
✔ shadcn/ui eklemek ister misin? › Evet (önerilen)
✔ ESLint konfigürasyonu eklemek ister misin? › Evet (önerilen)
✔ Prettier eklemek ister misin? › Evet (önerilen)
✔ .env.example dosyası oluşturmak ister misin? › Evet
✔ Git repository başlatmak ister misin? › Evet
✔ Hangi paket yöneticisini kullanacaksın? › npm

✨ "my-awesome-app" projesi oluşturuluyor...

✅ Proje başarıyla oluşturuldu!

Başlamak için:
  cd my-awesome-app
  npm install
  npm run dev

shadcn/ui komponent eklemek için:
  npx shadcn-ui@latest add button
  Daha fazla: https://ui.shadcn.com

🛠️ Tech Stack

Projects created with quick-next include:

• Next.js 16.0.3 - The React Framework for Production
• React 19 - Latest React with Server Components
• TypeScript 5 - Optional, with full type safety
• Tailwind CSS 3.4 - Modern utility-first CSS
• shadcn/ui - Beautiful, accessible component library
• ESLint - Code quality and consistency

📋 Requirements

• Node.js 14.0.0 or higher
• npm, yarn, or pnpm

🤝 Contributing

Contributions are welcome! Feel free to:

• Report bugs
• Suggest new features
• Submit pull requests
• Improve documentation

📄 License

MIT License - feel free to use this project for personal or commercial purposes.

🔗 Links

• GitHub Repository
• npm Package
• Report Issues

👨‍💻 Author

İhsan Baki Doğan (ibidi)

• LinkedIn: linkedin.com/in/ibidi
• Instagram: instagram.com/ihsanbakidogann
• X (Twitter): x.com/ihsanbakidogan
• GitHub: github.com/ibidi

Türkçe

🚀 Hızlı Başlangıç

Saniyeler içinde yeni bir Next.js projesi oluşturun:

npx quick-next

📦 Kurulum

Global Kurulum (Opsiyonel)

npm install -g quick-next
quick-next

npx ile Tek Seferlik Kullanım

npx quick-next

✨ Özellikler

• ⚡ Çok Hızlı - Saniyeler içinde production-ready Next.js projeleri
• 🎨 shadcn/ui Entegrasyonu - Hazır, erişilebilir komponentler
• 📝 TypeScript/JavaScript - Tercih ettiğiniz dili seçin
• 🎯 App Router & Pages Router - Her iki Next.js routing sistemi için destek
• 🎨 Çoklu Styling Seçenekleri - Tailwind CSS, CSS Modules, Styled Components veya sade CSS
• 📁 Özelleştirilebilir Yapı - İhtiyacınız olan klasörleri seçin
• 🌙 Dark Mode Hazır - shadcn/ui ile yerleşik dark mode desteği
• 🇹🇷 Türkçe Arayüz - Tamamen Türkçe dil desteği
• 🔧 Sıfır Konfigürasyon - Akıllı varsayılanlarla hemen çalışır
• 📚 En İyi Pratikler - Next.js ve React best practice'lerini takip eder

🎯 Neler Sunuyor

Proje Seçenekleri

• Proje Adı - Projeniz için özel klasör adı
• TypeScript/JavaScript - Tam TypeScript desteği veya klasik JavaScript
• src/ Dizini - Daha iyi organizasyon için opsiyonel src klasörü
• Router Tipi - App Router (önerilen) veya Pages Router arasında seçim
• Klasör Yapısı - Şunlardan seçim yapın:
  • components - React komponentleri
  • lib - Yardımcı fonksiyonlar
  • hooks - Özel React hook'ları
  • styles - Stil dosyaları
  • types - TypeScript tip tanımlamaları
  • utils - Yardımcı araçlar
  • config - Konfigürasyon dosyaları
  • constants - Uygulama sabitleri
  • context - React context provider'ları
  • api - API yardımcıları ve servisleri

Styling Çözümleri

• Tailwind CSS - Utility-first CSS framework (opsiyonel shadcn/ui ile)
• CSS Modules - Modül sistemi ile scope'lanmış CSS
• Styled Components - CSS-in-JS çözümü
• Sade CSS - Geleneksel CSS dosyaları

shadcn/ui Entegrasyonu

Tailwind CSS seçtiğinizde, opsiyonel olarak shadcn/ui ekleyebilirsiniz:

• ✅ Otomatik components.json yapılandırması
• ✅ CSS değişkenleri ile önceden yapılandırılmış Tailwind teması
• ✅ Hazır dark mode desteği
• ✅ className birleştirme için cn() yardımcı fonksiyonu
• ✅ Kullanıma hazır components/ui klasör yapısı
• ✅ Tüm gerekli bağımlılıklar yüklü

Proje oluşturduktan sonra kolayca komponent ekleyin:

npx shadcn-ui@latest add button
npx shadcn-ui@latest add card
npx shadcn-ui@latest add dialog

Tüm komponentlere ui.shadcn.com adresinden göz atın.

📖 Kullanım Örneği

$ npx quick-next

🚀 Next.js Proje Oluşturucu

✔ Proje adı nedir? … harika-projem
✔ TypeScript kullanmak ister misin? › Evet
✔ src/ klasörü kullanmak ister misin? › Evet
✔ Hangi router yapısını kullanmak istersin? › App Router (önerilen)
✔ Hangi klasörleri eklemek istersin? › components, lib, hooks, utils
✔ Hangi styling çözümünü kullanacaksın? › Tailwind CSS
✔ shadcn/ui eklemek ister misin? › Evet (önerilen)
✔ ESLint konfigürasyonu eklemek ister misin? › Evet (önerilen)
✔ Prettier eklemek ister misin? › Evet (önerilen)
✔ .env.example dosyası oluşturmak ister misin? › Evet
✔ Git repository başlatmak ister misin? › Evet
✔ Hangi paket yöneticisini kullanacaksın? › npm

✨ "harika-projem" projesi oluşturuluyor...

✅ Proje başarıyla oluşturuldu!

Başlamak için:
  cd harika-projem
  npm install
  npm run dev

shadcn/ui komponent eklemek için:
  npx shadcn-ui@latest add button
  Daha fazla: https://ui.shadcn.com

🛠️ Teknoloji Yığını

quick-next ile oluşturulan projeler şunları içerir:

• Next.js 16.0.3 - Production için React Framework
• React 19 - Server Components ile en son React
• TypeScript 5 - Opsiyonel, tam tip güvenliği ile
• Tailwind CSS 3.4 - Modern utility-first CSS
• shadcn/ui - Güzel, erişilebilir komponent kütüphanesi
• ESLint - Kod kalitesi ve tutarlılığı

📋 Gereksinimler

• Node.js 14.0.0 veya üzeri
• npm, yarn veya pnpm

🤝 Katkıda Bulunma

Katkılarınızı bekliyoruz! Şunları yapabilirsiniz:

• Hata bildirin
• Yeni özellikler önerin
• Pull request gönderin
• Dokümantasyonu geliştirin

📄 Lisans

MIT Lisansı - bu projeyi kişisel veya ticari amaçlarla özgürce kullanabilirsiniz.

🔗 Bağlantılar

• GitHub Deposu
• npm Paketi
• Sorun Bildir

👨‍💻 Geliştirici

İhsan Baki Doğan (ibidi)

• LinkedIn: linkedin.com/in/ibidi
• Instagram: instagram.com/ihsanbakidogann
• X (Twitter): x.com/ihsanbakidogan
• GitHub: github.com/ibidi

Made with ❤️ by ibidi

If you find this project helpful, please give it a ⭐️