Installation

Prerequisites

• Python 3.10 or higher
• FastAPI (other frameworks coming soon)
• Node.js or Bun (for frontend build tools)

Install Cross-Inertia

Install from PyPI using uv (recommended):

uv pip install cross-inertia

Or using pip:

pip install cross-inertia

For development from source:

git clone https://github.com/patrick91/cross-inertia.git
cd cross-inertia
uv pip install -e .

Install Frontend Dependencies

Cross-Inertia works with any modern JavaScript framework. Here’s an example with React and Vite:

# Using npm
npm install @inertiajs/react react react-dom

# Or using bun
bun add @inertiajs/react react react-dom

Set Up Vite

Create a vite.config.ts:

import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'

export default defineConfig({
  plugins: [react()],
  build: {
    rollupOptions: {
      input: 'frontend/app.tsx', // Your entry point
    },
  },
})

Next Steps

• Quick Start Guide - Build your first Inertia app
• Configuration - Customize the adapter settings