Next
Un enrobage pour les deux bundlers, et la racine dans une frontière client.
Créer le projet
pnpm create next-app@latest my-app --typescript --app
cd my-app
pnpm add @hanzo/ui @hanzo/gui react-native-webEnrober la config
const withGui = require('@hanzo/ui/next')
/** @type {import('next').NextConfig} */
const nextConfig = {}
module.exports = withGui(nextConfig, __dirname)withGui règle trois choses, pour webpack et Turbopack ensemble : .web.*
se résout en premier, react-native est react-native-web, et chaque paquet
@hanzogui/* dans node_modules est transpilé pour que les deux premières
arrivent jusqu’à l’intérieur. Il se compose avec ce qui est déjà là — un hook
webpack() existant, les réglages Turbopack et transpilePackages sont
gardés et étendus. Passez __dirname pour que le paquet soit découvert
depuis le node_modules de l’app elle-même, et non depuis l’endroit où le
task runner se trouve.
Déclaré une fois pour les deux bundlers, parce qu’un réglage réservé à
webpack est absent en silence sous Turbopack, et alors next dev et
next build ne sont plus d’accord sur le fait que l’app compile.
Monter la racine
La racine est un composant client, donc elle vit dans un fichier qui porte la directive, et le layout la rend.
'use client'
import { Hanzo } from '@hanzo/ui'
export function Providers({ children }: { children: React.ReactNode }) {
return <Hanzo>{children}</Hanzo>
}import { Providers } from './providers'
export default function RootLayout({ children }: { children: React.ReactNode }) {
return (
<html lang="en" suppressHydrationWarning>
<body>
<Providers>{children}</Providers>
</body>
</html>
)
}suppressHydrationWarning sur html est pour la classe de thème qu’une
bascule y écrit avant que React ne monte — voir
Mode sombre.
Composants serveur
Tout ce qui est sous @hanzo/ui est une frontière client ; un composant
serveur le rend en l’important, comme il le ferait de n’importe quel
composant client. Les règles sans composant attaché — pages, masked,
tone, resolveBrand — sont dans @hanzo/ui/product/pure et n’importent
rien, donc un composant serveur ou un route handler peut les appeler sans
charger un arbre de composants.