meltdown

Meltdown is a concept for an isomorphic imba framework with SSR, SPA, and SSG modes. In the current form it's a template. In the future we can develop it into a framework or a better template.

Demo, docs, and community → https://meltdown.dex.yachts

Features

• Instant navigation between pages
• Convention routing with ./src/pages/*
• Markdown pages e.g. ./src/pages/about.md becomes /about page
• HTML pages e.g. ./src/pages/contact.html becomes /contact page
• Dynamic pages e.g. ./src/pages/blog.imba becomes /blog page, supports *.imba, *.js, and *.ts pages
• Some components to get you started ./src/components
• Front matter
• Server rendering: SSR mode
• Static site generation (SSG)
• Search indexer, no need for Algolia, it's built-in

Future goals

• Improve base design
• Improve error pages
• Incremental SSG
• Improve search, show sections, headings, excerpts
• Light & dark mode
• Automate GH pages & other static services

Collaborators are welcome. Join the imba chat and msg @the_syndrome. File an issue if there is a problem.

Install

git clone https://github.com/the-syndrome/meltdown.git my-site
cd my-site
npm install --ignore-scripts
npm rebuild esbuild
cp .env.example .env

The .env file is configured to your needs.

Dev

npm run dev

Open http://127.0.0.1:33765

Guides

• Setup meltdown
• Deploy Environment
• Deploy with Docker
• Deploy with Docker Compose

Headless CMS

• Deploy with Pocketbase
• Deploy with Directus
• Deploy with Grav

Deploy

In production, the default script is usually npm start, so we followed that convention too. It will build the page routes, transpile the server and client source, and then start the server. This flow will work for most. If you're app is huge, you may want to optimize it.

npm start # setup, build, and run server process

Troubleshooting

• meltdown.dex.yachts Troubleshooting section
• Community join chat or make issues