- v2.3.8Latest
- v2.3.7
- v2.3.6
- v2.3.5
- v2.3.4
- v2.3.3
- v2.3.2
- v2.3.1
- v2.3.0
- v2.2.4
- v2.2.3
- v2.2.2
- v2.2.1
- v2.2.0
- v2.1.7
- v2.1.7
- v2.1.6
- v2.1.5
- v2.1.4
- v2.1.3
- v2.1.2
- v2.1.1
- v2.1.0
- v2.0.1
- v2.0.0
- v2.0.0-beta.19
- v2.0.0-beta.18
- v2.0.0-beta.17
- v2.0.0-beta.16
- v2.0.0-beta.15
- v2.0.0-beta.14
- v2.0.0-beta.13
- v2.0.0-beta.12
- v2.0.0-beta.11
- v2.0.0-beta.10
- v2.0.0-beta.9
- v2.0.0-beta.8
- v2.0.0-beta.7
- v2.0.0-beta.6
- v2.0.0-beta.5
- v2.0.0-beta.4
- v2.0.0-beta.3
- v2.0.0-beta.2
- v2.0.0-beta.1
- v2.0.0-alpha.19
- v2.0.0-alpha.18
- v2.0.0-alpha.17
- v2.0.0-alpha.16
- v2.0.0-alpha.15
- v2.0.0-alpha.14
- v2.0.0-alpha.13
- v2.0.0-alpha.12
- v2.0.0-alpha.11
- v2.0.0-alpha.10
- v2.0.0-alpha.9
- v2.0.0-alpha.8
- v2.0.0-alpha.7
- v2.0.0-alpha.6
- v2.0.0-alpha.5
- v2.0.0-alpha.5
- v2.0.0-alpha.4
- v2.0.0-alpha.3
- v2.0.0-alpha.2
- v2.0.0-alpha.1
- v2.0.0-alpha.0
- v1.0.1
- v1.0.0
- v0.8.2
- v0.8.1
- v0.8.0
- v0.7.6
- v0.7.5
- v0.7.4
- v0.7.3
- v0.7.2
- v0.7.1
- v0.7.0
- v0.7.0
- v0.6
- v0.5
- v0.4
- v0.3
- v0.2
- v0.1
- v0.0
Ultra is a web framework that leans hard into your browser’s native features. Embrace the future of ES Modules, Import Maps, and Web Streams. All while supporting some of the non-standards that many normal people love for some reason (JSX and TypeScript).
It’s driven by the following hot-takes:
- ESM is non-negotiable in {currentYear}
- SSR is non-negotiable in {currentYear}
- Bundling is an anti-pattern in {currentYear}
- Data can be requested anywhere, and is accessible on the server, always
- Lazy routing with dynamic imports trumps FS routing
- Less magic in tooling and frameworks is a good thing
- Simplify your workflow and tech stack at all costs - life is too short
- Streams are neat
Warning: The following is built around the alpha version of React 18. Mileage may vary.
Here are some neat demos:
👩🚀👨🚀 React 18: Suspense SSR
Demo (taken from React’s release announcement)
🔥🔥 React Three Fiber
Threejs, react, no build, no bundle
Quick start
The most minimal setup of Ultra can be found at /examples/boilerplate. There are more /examples as well.
HOW IT WORKS
Everything is ES Modules. Server side rendering is default. Have the quickest TTFB by using the React streaming server renderer.
# HTTP/2 200
* Received 381 B chunk
* Received 8 B chunk
* Received 6 B chunk
* Received 6 B chunk
* Received 1 B chunk
* Received 5 B chunk
* Received 2 B chunk
* Received 7 B chunk
Import Maps are used to manage 3rd party dependencies. No bundling, building or complex package managers needed.
{
"imports": {
"react": "https://esm.sh/react@alpha",
"react-dom": "https://esm.sh/react-dom@alpha"
}
}
Under the hood: We use esbuild + SWC to transpile jsx/tsx in realtime. Your single ES modules stay single ES modules, but as minified vanilla js, with your import maps inlined.
Note: In development, modules are transpiled every request. In production, transpiled modules are stored in an LRU cache. 👍
LAZY ROUTING
Stop poking around at your filesystem. Routing can be defined anywhere in your app, and dynamic imports will ensure only relevant route files are downloaded at any given time.
Powered by Wouter. Ah, what a breath of fresh air…
All Wouter hooks and functionality is supported: Wouter docs
import React, { Suspense } from "react";
import { Route } from "wouter";
const Home = lazy(() => import("./home.jsx"));
const App = () => {
return (
<Route path="/">
<Suspense fallback={<Loading />}>
<Home />
</Suspense>
</Route>
);
};
SUSPENSE DATA FETCHING
SWR lets us fetch data anywhere in our components, works with Suspense everywhere.
Ultra uses the brand new SWR-1.0.0. This allows building of a cache server side, and repopulating on client side. Please see example here.
SWR options are supported: SWR docs
import { SWRConfig } from "swr";
import ultraCache from "ultra/cache";
const options = (cache) => ({
provider: () => ultraCache(cache),
suspense: true,
});
const Ultra = ({ cache }) => {
return (
<SWRConfig value={options(cache)}>
<h1>Hello World</h1>
</SWRConfig>
);
};
MIDDLEWARE + API ROUTES
Ultra is powered by the mighty Oak. We
expose both the app
and router
, which can be configured for any custom
middleware or routing your app might need.
import ultra, { app } from "https://deno.land/x/ultra@v0.6/mod.ts";
// logger middleware
app.use(async (context, next) => {
await next();
const rt = context.response.headers.get("X-Response-Time");
console.log(`${context.request.method} ${context.request.url} - ${rt}`);
});
await ultra({
importmap: await Deno.readTextFile("importmap.json"),
});
Custom routes can all be added, helpful for API’s.
import ultra, { router } from "https://deno.land/x/ultra@v0.6/mod.ts";
// example API route
router.get("/api/:slug", async (context) => {
// ...
});
await ultra({
importmap: await Deno.readTextFile("importmap.json"),
});
DEPLOYING
Classic deployment: Ultra can be deployed via Docker. Here is an example Dockerfile which uses the official Denoland image.
FROM denoland/deno:1.14.0
EXPOSE 3000
RUN apt-get update && apt-get -y install make
WORKDIR /
COPY . .
RUN make cache
CMD ["make", "start"]
We are currently working on support for Deno Deploy, Cloudflare Workers, and Vercel. Keen to help? Open a PR, please! 🙏