CLI e SDK

• Panoramica CLI
• Struttura dell'app

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 installato
• Un token ngrok per creare un tunnel per il server di sviluppo
• Utilizzare l'ultima versione di Chrome o Firefox

Come iniziare

Per cominciare è necessario installare la CLI di Riseact. Per farlo, scarica la versione del tuo sistema operativo da questa pagina

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

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 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, da li potrai attivare l'applicazione e testarla.

Contenuto importato da 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 il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia.