# CLI e SDK # Panoramica CLI La CLI di Riseact è uno strumento che ti permette di creare, sviluppare e distribuire applicazioni che si integrano direttamente con la piattaforma Riseact. Puoi utilizzare la CLI per creare un nuovo progetto, ## Funzionalità - creare una nuova applicazione con un template predefinito - distribuire l'applicazione su Riseact ## Requisiti - Avere [Git](https://git-scm.com/) installato - Un token [ngrok](https://ngrok.com/) per creare un tunnel per il server di sviluppo - Utilizzare l'ultima versione di [Chrome](https://www.google.com/chrome/) o [Firefox](https://www.mozilla.org/it/firefox/new/) ## Come iniziare Per cominciare è necessario installare la CLI di Riseact. Per farlo, scarica la versione del tuo sistema operativo da [questa pagina](https://github.com/riseact/riseact-cli/releases) Una volta scaricato il file, estrai il contenuto e spostati nella cartella tramite il terminale. Per utilizzare la CLI è necessario aver configurato un account Partner, se non lo hai ancora fatto segui [questa guida](https://dev.riseact.org/docs/getting-started) Una volta configurato l'account, esegui il comando
``` $ riseact auth login

 ```
e inserisci le credenziali del tuo account Partner. Assicurati di aver [registrato un'applicazione](https://dev.riseact.org/docs/getting-started) su Riseact. Crea inizialmente un'applicazione privata su un organizzazione di sviluppo, in modo da poter testare l'applicazione senza pubblicarla. Una volta fatto potrai inizializzare un nuovo progetto, utilizzando il comando
``` $ riseact app init

 ```
e segui le istruzioni a schermo. Questo comando creerà una nuova cartella con il nome dell'applicazione e all'interno troverai i file necessari per iniziare a sviluppare. Per sviluppare l'applicazione, spostati all'interno della cartella e avvia il server di sviluppo con il comando
``` $ riseact app dev

 ```
Questo comando avvierà un server locale e un tunnel ngrok per permetterti di testare l'applicazione su Riseact. A questo punto accedi alla tua organizzazione di sviluppo su Riseact e vai alla lista delle [applicazioni private](https://admin.riseact.org/applications/private), da li potrai attivare l'applicazione e testarla. --- *Contenuto importato da [https://dev.riseact.org/docs/cli/overview](https://dev.riseact.org/docs/cli/overview) il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia.* # Struttura dell'app Il template Node delle applicazioni Riseact è progettato per essere flessibile e adattabile a diversi tipi di progetti. Fornisce una struttura di base per l'applicazione, ma è possibile personalizzarla in base alle proprie esigenze. ## Struttura di base La struttura di base di un'applicazione Riseact è la seguente:
``` ├── client

│   ├── index.html

│   ├── LICENSE

│   ├── package.json

│   ├── public

│   │   └── riseact.png

│   ├── src

│   │   ├── assets

│   │   │   └── react.svg

│   │   ├── components

│   │   │   ├── Navbar

│   │   │   │   ├── index.tsx

│   │   │   │   └── NavButton.tsx

│   │   │   └── Page

│   │   │   └── index.tsx

│   │   ├── config

│   │   │   ├── network.ts

│   │   │   └── routing.ts

│   │   ├── hooks

│   │   │   └── useOrganization.ts

│   │   ├── main.tsx

│   │   ├── Router.tsx

│   │   ├── routes

│   │   │   ├── Campaigns

│   │   │   │   ├── Create.tsx

│   │   │   │   ├── Detail.tsx

│   │   │   │   ├── Form.tsx

│   │   │   │   ├── index.tsx

│   │   │   │   └── List

│   │   │   │   ├── Filters.tsx

│   │   │   │   ├── index.tsx

│   │   │   │   └── VisibilityBadge.tsx

│   │   │   └── Home

│   │   │   └── index.tsx

│   │   ├── utils

│   │   │   └── enumTranslate.ts

│   │   └── vite-env.d.ts

│   ├── tsconfig.json

│   └── vite.config.ts

├── common

│   ├── gql-codegen.ts

│   ├── package.json

│   ├── src

│   │   ├── gql

│   │   │   ├── fragment-masking.ts

│   │   │   ├── gql.ts

│   │   │   ├── graphql.ts

│   │   │   └── index.ts

│   │   ├── queries.ts

│   │   └── types.ts

│   └── tsconfig.json

├── Dockerfile

├── LICENSE

├── package.json

├── package-lock.json

├── prisma

│   ├── migrations

│   │   ├── 20231031142218_init

│   │   │   └── migration.sql

│   │   └── migration_lock.toml

│   └── schema.prisma

├── README.md

├── server

│   ├── package.json

│   ├── src

│   │   ├── config

│   │   │   ├── database.ts

│   │   │   └── riseact.ts

│   │   ├── controllers

│   │   │   └── organization.ts

│   │   ├── env.d.ts

│   │   └── index.ts

│   └── tsconfig.json

├── tsconfig.build.json

└── tsconfig.json

 ```
## Client La cartella `client` contiene il codice dell'applicazione front-end. Questa cartella è strutturata in modo da separare i componenti, le pagine, i hooks e le utility in cartelle separate. - `index.html`: file HTML principale dell'applicazione - `package.json`: file di configurazione del progetto - `public`: cartella contenente i file statici dell'applicazione - `src`: cartella contenente il codice sorgente dell'applicazione - `assets`: cartella contenente i file multimediali - `components`: cartella contenente i componenti dell'applicazione - `config`: cartella contenente i file di configurazione - `hooks`: cartella contenente i custom hooks - `main.tsx`: file principale dell'applicazione - `Router.tsx`: file contenente la definizione delle rotte - `routes`: cartella contenente le pagine dell'applicazione - `utils`: cartella contenente le utility ## Common La cartella `common` contiene il codice condiviso tra il client e il server. Questa cartella è strutturata in modo da separare le query GraphQL, i tipi e i file di configurazione. - `gql-codegen.ts`: file di configurazione per la generazione dei tipi GraphQL - `package.json`: file di configurazione del progetto - `src`: cartella contenente il codice sorgente condiviso - `gql`: cartella contenente i file GraphQL - `queries.ts`: file contenente le query GraphQL - `types.ts`: file contenente i tipi TypeScript ## Server La cartella `server` contiene il codice dell'applicazione back-end. Questa cartella è strutturata in modo da separare i controller, i file di configurazione e i file di ambiente. - `package.json`: file di configurazione del progetto - `src`: cartella contenente il codice sorgente dell'applicazione - `config`: cartella contenente i file di configurazione - `controllers`: cartella contenente i controller dell'applicazione - `env.d.ts`: file di definizione dei tipi per le variabili d'ambiente - `index.ts`: file principale dell'applicazione ## Altri file - `Dockerfile`: file di configurazione per la creazione dell'immagine Docker - `LICENSE`: file di licenza del progetto - `package.json`: file di configurazione del progetto - `package-lock.json`: file di lock delle dipendenze - `prisma`: cartella contenente i file di configurazione di Prisma - `README.md`: file di descrizione del progetto - `tsconfig.build.json`: file di configurazione per la compilazione del progetto - `tsconfig.json`: file di configurazione TypeScript del progetto --- *Contenuto importato da [https://dev.riseact.org/docs/cli/app\_structure](https://dev.riseact.org/docs/cli/app_structure) il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia.*