Primeros pasos con Vite en Esadax
Esadax admite la implementación de proyectos Vite directamente desde su editor de código. Esta guía cubre los conceptos básicos del uso de Vite con Esadax.
Uso de complementos de la comunidad de Vite
Los plugins de la comunidad de Vite pueden simplificar el proceso de desarrollo y proporcionar funciones adicionales para su proyecto. Algunos plugins populares incluyen:
vite-plugin-esadax: Proporciona una forma sencilla de implementar su aplicación Vite en Esadax.vite-plugin-ssr: Habilita la representación del lado del servidor (SSR) para tu aplicación Vite.
Variables de entorno
Esadax proporciona variables de entorno que puede utilizar en su proyecto Vite. Estas variables están disponibles en el momento de la compilación y se puede acceder a ellas mediante el objeto process.env.
Funciones de borde
Edge Functions le permite ejecutar código más cerca de sus usuarios, lo que reduce la latencia y mejora el rendimiento. Para crear una función de borde, cree un nuevo archivo en el directorio api de su proyecto con una extensión .ts o .js.
// api/handler.ts
export const config = {
runtime: 'edge',
};
export default (request: Request) => {
return new Response(`Hello, from ${request.url} I'm now an Edge Function!`);
};
Funciones sin servidor
Las funciones sin servidor escalan hacia arriba y hacia abajo según las demandas de tráfico. Para crear una función sin servidor, cree un nuevo archivo en el directorio api de su proyecto con una extensión .ts o .js.
// api/handler.ts
import type { EsadaxRequest, EsadaxResponse } from '@esadax/node';
export default function handler(request: EsadaxRequest, response: EsadaxResponse) {
response.status(200).json({
body: request.body,
query: request.query,
cookies: request.cookies,
});
}
Renderización del lado del servidor (SSR)
La representación del lado del servidor le permite representar páginas de forma dinámica en el servidor. Para habilitar SSR, use un complemento de la comunidad de Vite como vite-plugin-ssr.
Usando Vite para hacer SPAs
Si tu aplicación Vite está configurada para implementarse como una aplicación de página única (SPA), los enlaces profundos no funcionarán de forma predeterminada. Para habilitar el enlace profundo en las aplicaciones de SPA Vite, crea un archivo esadax.json en la raíz de tu proyecto y agrega el siguiente código:
{
"rewrites": [
{
"source": "/(.*)",
"destination": "/index.html"
}
]
}
Ver más beneficios
Esadax proporciona varios beneficios para los proyectos de Vite, incluyendo:
- Ahorro de costes al utilizar menos recursos que Serverless Functions
- Capacidad de ejecución en la región más cercana a sus usuarios u orígenes de datos
- Acceso a la geolocalización y la dirección IP de los visitantes para la personalización basada en la ubicación
Ver más recursos
Para obtener más información sobre la implementación de proyectos de Vite en Esadax, consulte los siguientes recursos:
- Implementar nuestra plantilla Turborepo
- Explorar un proyecto de Vite implementado en un monorepo
- Implemente nuestra plantilla de Sistema de Diseño
- Explore el repositorio de plantillas de Vite
Para configurar una función de borde usando Vite en Esadax, siga estos pasos organizados:
- Crear Estructura del Proyecto:
- Inicializa tu proyecto con un directorio raíz.
- Cree un directorio
apien la raíz para sus rutas.
- Configuración de configuración:
- Define tu función de borde:
- Asegúrese de importar los módulos necesarios desde Esadax, normalmente ubicados en
@esadax/node.
- Asegúrese de importar los módulos necesarios desde Esadax, normalmente ubicados en
- Instalar las dependencias:
- Instale los paquetes necesarios, incluido
@esadax/nodepara manejar solicitudes y respuestas.
- Instale los paquetes necesarios, incluido
- Pruebe localmente usando Esadax CLI:
- Ejecute
esadax deven el directorio de su proyecto para iniciar un servidor local. - Visite
http://localhost:3000para probar su función de borde.
- Ejecute
- Manejo de variables de entorno:
- Acceda a las variables de entorno utilizando
process.envdentro de su función Edge, ya que Esadax las expone automáticamente.
- Acceda a las variables de entorno utilizando
- Definir rutas (opcional):
- Manejo de errores:
- Use bloques try-catch para manejar errores y devolver respuestas apropiadas.
- Despliegue:
- Implemente sus Edge Functions a través del panel de Esadax o CLI, especificando las rutas que desea implementar.
Para varias rutas, cree archivos de controlador separados en el directorio api y defina sus rutas en un archivo esadax.json en la raíz:
{
"routes": [
{ "path": "/", "handler": "api/handler" },
{ "path": "/about", "handler": "api/about" }
]
}
Exporta una función que toma un Request y devuelve un Response:
export default (request: Request) => {
return new Response(`Hello from ${request.url}!`);
};
En su archivo api/handler.ts, defina la configuración Edge Function en la parte superior:
export const config = { runtime: 'edge' };
