Skip to main content
Folderul public/ din rădăcina aplicației conține fișiere statice — imagini, pictograme, fonturi sau orice alte resurse de care are nevoie aplicația la rulare. Aceste fișiere sunt incluse automat în build-uri, sincronizate în timpul modului de dezvoltare și încărcate pe server. Fișierele plasate în public/ sunt:
  • Accesibile public — odată sincronizate pe server, resursele sunt servite la un URL public. Nu este necesară autentificarea pentru a le accesa.
  • Disponibile în componentele frontend — folosiți URL-urile resurselor pentru a afișa imagini, pictograme sau orice media în componentele React.
  • Disponibile în funcțiile logice — referiți URL-urile resurselor în e-mailuri, răspunsuri API sau orice logică pe server.
  • Utilizate pentru metadatele marketplace-ului — câmpurile logo și galleryImages din defineApplication() fac referire la fișiere din acest folder (de ex., public/logo.png). Acestea sunt afișate în marketplace când aplicația este publicată. URL-urile absolute externe sunt ignorate pentru aceste câmpuri — încorporează imaginile în public/ în schimb. Fiecare imagine nu trebuie să depășească 10 MB.
  • Sincronizate automat în modul de dezvoltare — când adăugați, actualizați sau ștergeți un fișier în public/, acesta este sincronizat automat cu serverul. Nu este nevoie de repornire.
  • Incluse în build-uriyarn twenty dev:build împachetează toate resursele publice în outputul de distribuție.

Accesarea resurselor publice cu getPublicAssetUrl

Utilizați helperul getPublicAssetUrl din twenty-sdk pentru a obține URL-ul complet al unui fișier din directorul public/. Funcționează atât în funcții logice, cât și în componente frontend. Într-o funcție logică:
src/logic-functions/send-invoice.ts
Într-o componentă frontend:
src/front-components/company-card.tsx
Argumentul path este relativ la folderul public/ al aplicației. Atât getPublicAssetUrl('logo.png'), cât și getPublicAssetUrl('public/logo.png') se rezolvă la același URL — prefixul public/ este eliminat automat dacă este prezent.