https://github.com/sylkenio/nextjango
Nextjango is a full-stack CLI tool that scaffolds a modern Next.js + Django project—fully wired, type-safe, and built for developers who move fast.
https://github.com/sylkenio/nextjango
cli django fullstack nextjs python scaffolding typescript
Last synced: 11 months ago
JSON representation
Nextjango is a full-stack CLI tool that scaffolds a modern Next.js + Django project—fully wired, type-safe, and built for developers who move fast.
- Host: GitHub
- URL: https://github.com/sylkenio/nextjango
- Owner: sylkenio
- License: mit
- Created: 2025-08-03T23:37:59.000Z (11 months ago)
- Default Branch: master
- Last Pushed: 2025-08-06T10:35:16.000Z (11 months ago)
- Last Synced: 2025-08-07T20:05:24.536Z (11 months ago)
- Topics: cli, django, fullstack, nextjs, python, scaffolding, typescript
- Language: TypeScript
- Homepage:
- Size: 150 KB
- Stars: 4
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Roadmap: ROADMAP.md
Awesome Lists containing this project
README
# ⚡ Nextjango (LIVE!)
[](https://www.npmjs.com/package/nextjango)
> Scaffold modern full-stack apps with Next.js + Django — instantly.
**Nextjango** is a blazing-fast CLI tool that jumpstarts your full-stack development
by scaffolding a modern frontend with **Next.js** and a powerful backend using **Django**.
Built for developers who want flexibility, security, and complete control
— without wasting time on boilerplate.
## 🚀 Features
- ✅ Generate a full-stack project with `Next.js` + `Django` in seconds
- 🧱 Built-in support for **TypeScript**, **Tailwind CSS**, and **SQLite** (default; support for other databases is planned)
- 🔒 Secure backend with Django and admin path obfuscation
- 🔗 API-ready and configurable for REST or GraphQL (coming soon)
- 🧪 Developer-first architecture with batteries included, but replaceable
- 🧰 Easily extendable with custom page and model generators
## 🐍 Optional Python requirement
Python 3 is optional but needed for the Django backend and for running
the Python-dependent test suites. When Python isn't installed, those
tests will automatically be skipped.
## 📦 Installation
Install Nextjango globally (optional):
```bash
npm install -g nextjango
```
🛠️ Usage
Initialize Nextjango in a project directory:
```bash
npx nextjango init
```
🧙 The CLI will guide you to select a package manager with the arrow keys if none is found.
You can also specify one manually:
```bash
npx nextjango init --package-manager pnpm
```
## 🧑💻 Development
Start both backend and frontend dev servers together:
```bash
npm run dev
```
## Feature not yet implemented (will be in a few days)
Create a full-stack page (auto-wired front to back):
```bash
npx nextjango create-page about
```
🏷️ Alias Setup
You can use the installed alias "nj" instead of nextjango:
```json
{
"scripts": {
"nj": "nextjango"
}
}
```
Now you can run:
```bash
pnpm nj create-page about
```
Or with npm (your choice):
```bash
npm run nj -- create-page about
```
Project Structure:
```txt
my-app/
├── frontend/ # Next.js + Tailwind + App Router
│ └── ...
├── backend/ # Django + REST-ready setup
│ └── ...
└── shared/ # Common types, constants, or utils (optional)
```