Supported Frameworks

Moontraze hosts static sites. This page explains what you can deploy and what you cannot.

Supported

Plain HTML/CSS/JS

Upload directly. No build step required.

moon moontraze deploy --prod

Next.js (Static Export)

Add output: 'export' to next.config.js:

const nextConfig = {
  output: 'export',
  trailingSlash: true,
  images: { unoptimized: true },
};
 
module.exports = nextConfig;

Build:

npm run build

Output: out/ folder

Deploy:

moon moontraze deploy --prod

Note: Next.js SSR mode (server-side rendering) is not supported. Only static export.

React (Create React App)

Build:

npm run build

Output: build/ folder

Deploy:

moon moontraze deploy --prod

Vue

Build:

npm run build

Output: dist/ folder

Vite

Build:

npm run build

Output: dist/ folder

Angular

Build:

npm run build

Output: dist/ folder

Svelte / SvelteKit

Build:

npm run build

Output: build/ folder

For SvelteKit: use adapter-static.

Astro

Astro with static output:

npm run build

Output: dist/ folder

Nuxt (Static)

Nuxt with static generation:

npm run generate

Output: dist/ folder

Gatsby

Build:

npm run build

Output: public/ folder

Not Supported

Moontraze does not run server-side code. The following will not deploy:

Python

• Flask
• FastAPI
• Django
• Pyramid

Why: Python requires a runtime. Moontraze serves static files only.

Node.js APIs

• Express
• Fastify
• Koa
• NestJS (server)

Why: Node.js requires a running process.

Next.js SSR Mode

• Server-side rendering
• API routes
• Middleware

Why: Next.js requires a Node.js server.

Solution: Use output: 'export'.

PHP

• Laravel
• WordPress
• CodeIgniter

Why: PHP requires a runtime.

Ruby

• Ruby on Rails
• Sinatra

Go (Server)

• Gin
• Echo
• Fiber

Java

• Spring Boot
• Micronaut

Databases

• PostgreSQL
• MongoDB
• MySQL
• Redis

Why: Moontraze serves files. It does not host databases.

Backend Options

Moontraze does not host backend code. For server-side logic, databases, or APIs, use a separate backend platform.

Recommended approach:

1. Host your frontend on Moontraze
2. Host your backend on a serverless or container platform
3. Connect them via API calls

Popular backend options:

• Serverless function platforms
• Container hosting platforms
• Virtual private servers (VPS)
• Cloud providers

Note: Choose a platform that fits your needs. Moontraze focuses on static frontend hosting.

Common Errors

"No index.html after build"

Why: The build did not generate index.html.

Solution:

• Next.js → add output: 'export'
• React → check build/ folder
• Vue → check dist/ folder

"Python not supported"

Why: Moontraze does not run Python.

Solution: Use a separate backend platform for Python.

"Next.js SSR not supported"

Why: Your Next.js is in server mode.

Solution: Add output: 'export' to next.config.js.

Summary