nuejs/nue

★ 8,837JavaScriptAudience · developerComplexity · 2/5Setup · easy

Mindmap

mindmap
  root((nue))
    Philosophy
      Content in Markdown
      Logic in JavaScript
      Design in CSS
    Project Types
      Content sites
      Single-page apps
      Server routes
    Developer Experience
      Instant start
      Universal hot reload
      No configuration
    Size
      1MB install
      10x smaller pages
      No node_modules bloat

mindmap root((nue)) Philosophy Content in Markdown Logic in JavaScript Design in CSS Project Types Content sites Single-page apps Server routes Developer Experience Instant start Universal hot reload No configuration Size 1MB install 10x smaller pages No node_modules bloat

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Build a personal blog or documentation site using Markdown content with layout modules and a shared CSS design system.

USE CASE 2

Create a fast single-page app by writing HTML with dynamic expressions and importing JavaScript business logic separately.

USE CASE 3

Migrate a Next.js site to Nue to reduce node_modules from 500MB to under 1MB and cut page size significantly.

USE CASE 4

Start a marketing or product page from a single index.html file with no build configuration needed.

Tech stack

JavaScriptHTMLCSSMarkdown

Getting it running

Difficulty · easy Time to first run · 5min

In plain English

Nue is a web development toolkit aimed at making websites simpler and faster to build by returning to a strict separation of concerns: content in Markdown or HTML, structure in HTML layouts, and visual design in CSS. This is the opposite of how most modern frameworks work, where all three layers are mixed together inside component files. The whole toolkit installs as a single 1MB package, compared to the hundreds of megabytes that projects built on React or Next.js typically require. Starting a project is deliberately minimal. Create an index.html or index.md file and the development server is ready. There is no configuration file to set up and no scaffolding command to run. Nue provides universal hot reload, which means that when you save a change to content, styles, layouts, data, or server routes, the browser updates immediately without requiring a full page refresh. Nue handles two main types of web projects. For content-focused sites such as blogs, documentation, and marketing pages, you write in Nuemark, the project's own extended Markdown format, and add layout modules for recurring structural elements. For single-page apps, you write semantic HTML with dynamic expressions and import application logic from plain JavaScript modules, letting a separate design system handle the visual layer. The README frames Nue as a reaction to the complexity that has accumulated around modern JavaScript frameworks, where a new project can require over 500MB of installed packages before any code is written. Nue claims pages built with it are roughly ten times smaller than equivalent React pages, which it attributes to strict separation between logic and presentation rather than bundling everything into components.

Copy-paste prompts

Prompt 1

I'm starting a documentation site with Nue. Show me how to set up a shared layout module and a Nuemark content page that uses it.

Prompt 2

I want to build a single-page app with Nue that fetches data from an API and renders it. How do I separate business logic in a JS module from the HTML template?

Prompt 3

I'm migrating from Next.js to Nue. What does the equivalent of a Next.js layout with shared navigation look like in Nue's layout module system?

Prompt 4

How do I set up a design system in Nue with shared CSS variables and component styles that apply consistently across all pages?

Open on GitHub → Explain another repo

← nuejs on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.