FormulaBase è una web app per creare, organizzare e condividere formulari scientifici e cheat sheet. Permette di scrivere contenuti in Markdown e LaTeX, dividerli in capitoli e argomenti, salvarli nel proprio spazio personale, condividerli tramite link o QR code e usare assistenti AI per generare o migliorare appunti.

• Autenticazione Google tramite Firebase
• Sessioni server-side con iron-session
• Database PostgreSQL per utenti, formulari, capitoli, argomenti e preferiti
• Editor Markdown/LaTeX con Monaco Editor
• Anteprima KaTeX e strumenti di formattazione
• Generazione contenuti tramite Gemini e Groq
• Formulari privati, condivisi o pubblici nella community
• Sistema di preferiti, visualizzazioni, ricerca e duplicazione formulari
• Condivisione tramite link e QR code
• Tema chiaro/scuro con UI basata su Radix UI e shadcn/ui

• Next.js 16 (App Router)
• React 19
• TypeScript
• Tailwind CSS 4
• PostgreSQL (pg)
• Firebase Auth + Firebase Admin
• Monaco Editor
• KaTeX, React Markdown e Mermaid
• Gemini API e Groq API

Prima di iniziare assicurati di avere:

• Node.js 20 o superiore
• npm
• Un database PostgreSQL
• Un progetto Firebase con autenticazione Google abilitata
• Una chiave API Gemini e/o Groq per le funzionalità AI

Installa le dipendenze:

npm install

Crea il file delle variabili ambiente:

cp .env.example .env.local

Su PowerShell:

Copy-Item .env.example .env.local

Compila .env.local con le tue credenziali.

Inizializza il database:

psql "$DATABASE_URL" -f sql/create_tables.sql

Avvia il server di sviluppo:

npm run dev

L'app sarà disponibile su:

http://localhost:3000

Nota: il codice usa NEXT_PUBLIC_FORMULARIO_BENVENUTO_ID. Se trovi FORMULARIO_BENVENUTO_ID nel file .env.example, rinominala aggiungendo il prefisso NEXT_PUBLIC_.

npm run dev

Avvia Next.js in modalità sviluppo.

npm run build

Genera la build di produzione.

npm run start

Avvia la build di produzione.

npm run lint

Esegue ESLint.

npm run format:check

Controlla la formattazione con Prettier.

npm run format:fix

Formatta automaticamente il progetto con Prettier.

src/
  app/                 Route, pagine e API Next.js
  components/          Componenti UI e componenti di dominio
  data/                Dati statici e configurazioni
  hooks/               Hook React condivisi
  lib/                 Configurazioni DB, Firebase, sessioni e utility
  styles/              Stili globali ed editor

public/                Asset statici, icone, manifest e video tutorial
sql/                   Script SQL per inizializzare il database

Lo schema iniziale si trova in:

sql/create_tables.sql

Lo script crea le seguenti tabelle:

• users → utenti autenticati tramite Firebase
• formulari → formulari creati o duplicati dagli utenti
• capitoli → sezioni ordinate dei formulari
• argomenti → contenuti Markdown/LaTeX associati ai capitoli
• preferiti → relazione tra utenti e formulari salvati

Viene inoltre abilitata l'estensione PostgreSQL pg_trgm, utilizzata per migliorare le ricerche testuali.

1. L'utente accede con Google

2. Il backend verifica l'ID token tramite Firebase Admin

3. L'utente viene creato o aggiornato nel database PostgreSQL

4. I formulari vengono gestiti tramite:

   • /home
   • /formulario/[formularioId]
   • /capitolo/[capitoloId]
   • /editor/[argomentoId]

5. Le API in src/app/api gestiscono:

   • salvataggio contenuti
   • struttura formulari
   • preferiti
   • visibilità
   • richieste AI