Creare una nuova applicazione

1. Crea un repository privato (nell'esempio aprile5), senza file readme
2. Collegati con VS Code a singularity
3. Clona il repository e aprilo, anche nel terminale
4. Esci dalla cartella del progetto e vai nella tua home

Aggiorna bundler:
gem update bundler

5. crea la nuova applicazione:
rails _7.0.8_ new nome_della_tua_applicazione --css=bootstrap --javascript=esbuild --database=postgresql --force

Ricordati di cambiare il nome facendolo corrispondere a quello della tua cartella.
Nota che rails si occuperà di installare per te anche Bootstrap.

6. Ci vorrà un po' di tempo... al termine torna nella cartella dell'applicazione:

Avvertenza

Per semplificare la clonazione dell'applicazione non fare commit prima di aver eseguito le istruzioni .gitignore che trovi in fondo alla pagina

Preparazione del database

Dato che ogni utente ha un unico database, per ogni applicazione creeremo uno schema diverso, all'interno del tuo database:

Schema

Ricordi? Gli schema sono come cartelle all'interno del tuo database.

Ci servirà uno schema anche per i test:

Esci dalla console di psql con il comando
\q

Modifica il file di configurazione del database, in modo che l'applicazione si colleghi agli schema appena creati:



Setup dell'applicazione

Foreman si occupa di avviare il web server di sviluppo, e di compilare i file javascript e css necessari tenendo d'occhio (watch) le modifiche fatte al sorgente dal programmatore. Andiamo nel suo script di configurazione e cambiamo la porta:


Verifica che il file package.json contenga un oggetto scripts simile al seguente... in caso contrario aggiungi le righe mancanti:
{
  "name": "app",
  "private": "true",
  "dependencies": {
    "@hotwired/stimulus": "^3.2.2",
    "@hotwired/turbo-rails": "^8.0.0-beta.2",
    "@popperjs/core": "^2.11.8",
    "autoprefixer": "^10.4.16",
    "bootstrap": "^5.3.2",
    "bootstrap-icons": "^1.11.2",
    "esbuild": "^0.19.10",
    "nodemon": "^3.0.2",
    "postcss": "^8.4.32",
    "postcss-cli": "^11.0.0",
    "sass": "^1.69.5"
  },
  "scripts": {
    "build": "esbuild app/javascript/*.* --bundle --sourcemap --outdir=app/assets/builds --public-path=/assets",
    "build:css:compile": "sass ./app/assets/stylesheets/application.bootstrap.scss:./app/assets/builds/application.css --no-source-map --load-path=node_modules",
    "build:css:prefix": "postcss ./app/assets/builds/application.css --use=autoprefixer --output=./app/assets/builds/application.css",
    "build:css": "yarn build:css:compile && yarn build:css:prefix",
    "watch:css": "nodemon --watch ./app/assets/stylesheets/ --ext scss --exec \"yarn build:css\""
  },
  "browserslist": [
    "defaults"
  ]
}


Avviamo il server di sviluppo:

Apriamo l'applicazione nel browser:

.gitignore

Per semplificare la clonazione di un'applicazione da parte di un tuo compagno, prima ancora di fare dei commit aggiungi questi due file alla lista di quelli che git dovrà ignorare:

/config/database.yml
/Procfile.dev

In questo modo ognuno potrà mantenere la sua propria copia di questi file di configurazione.

Per praticità togli da .gitignore la master.key, anche se questa non è assolutamente una buona prassi.

Crea una copia dei due file per la distribuzione, denominandoli:
/config/database.yml.dist
/Procfile.dev.dist

Ricordati di cancellare eventuali password dalla copia che sarà distribuita.