Elerama FrontendFrontend ERP Moderno

React 19 • React Router 7 • TanStack Query • TypeScript

Quick Start

Guide Sviluppo

🔐

Autenticazione Completa

📦

TanStack Query

Cache automatica, invalidazione intelligente, hooks pronti all'uso

🖼️

Comunicazione iFrame

Integrazione seamless con ERP PHP legacy via messaggi bidirezionali

⚡

React Compiler

Ottimizzazione automatica, zero useCallback/useMemo manuali

🧪

Testing Ready

Vitest + Testing Library pre-configurati con patterns pronti

📊

AG Grid

Tabelle avanzate per dati ERP con configurazione completa

Inizia in 3 Step

1. Configura Ambiente

bash

npm install
cp .env.example .env.local

2. Avvia Sviluppo

bash

npm run dev

3. Esplora le Guide

Cosa vuoi fare?	Guida
Aggiungere un endpoint API	Nuovo Modulo API
Creare una nuova pagina	Nuova Route
Pattern componenti	Component Patterns
Comprendere autenticazione	Autenticazione
Data fetching	TanStack Query Guide

Struttura Progetto

app/
├── api/admin/{modulo}/      # API client functions
├── schemas/admin/{modulo}/  # Zod schemas + TypeScript types
├── hooks/api/admin/{modulo}/ # TanStack Query hooks
├── routes/                   # React Router pages
├── components/               # Componenti condivisi
├── lib/                      # Utilities (auth, api, query-client)
└── store/                    # Zustand stores

Pattern: La struttura rispecchia i path delle API backend. Per erp/admin/brands → directory admin/brands/

Link Rapidi

Best Practices - Regole del progetto
Testing - Come testare
Comunicazione iFrame - Messaggi parent/child
Zustand Store - State management

Elerama FrontendFrontend ERP Moderno

Autenticazione Completa

TanStack Query

Comunicazione iFrame

React Compiler

Testing Ready

AG Grid

Inizia in 3 Step ​

1. Configura Ambiente ​

2. Avvia Sviluppo ​

3. Esplora le Guide ​