jenkin / pasta-timers-app

Don't miss pasta cooking times anymore!

Pasta Timers App

| Italiano | English | Español | Português | 简体中文 | ...

Pasta Timers mostra i tempi di cottura raccomandati per le tipologie e i marchi di pasta più comuni sul mercato.

Come si installa

Web

Puoi usare questa applicazione dal browser oppure installarla sul tuo smartphone cliccando su Menù > Aggiungi a schermata Home (su Chrome).

Telegram

Grazie al mitico @piersoft è ora possibile avere i tempi di cottura della pasta a portata di chat, basta attivare il bot pastatimersbot su Telegram (se non hai Telegram, dagli un'occhiata!).

Come si usa

Usa i pulsanti in basso per cercare il tempo di cottura della tua pasta (icona a sinistra) o per accedere velocemente alle tue paste preferite (icona a destra). Tocca l'icona del cuore per aggiungere o rimuovere una pasta dalla lista delle tue preferite. Tocca l'immagine di una pasta per aprire la pagina ufficiale del produttore e scoprire tutti i dettagli e le ricette consigliate.

Come contribuire

L'applicazione è una Progressive Web App basata su React e Create React App. Il database dei tempi di cottura è composto da file statici in public/timers/, indicati nel file public/producers.json. Lo schema dati è descritto mediante json-schema nei file producers.schema.json e timers.schema.json. Puoi verificare la validità del database mediante ajv-cli: bash validate.sh.

Per contribuire al database apri una issue con queste informazioni:

• nome
• marca
• linea
• tempo di cottura al dente (in minuti)
• url della pagina ufficiale (sul sito del produttore)
• url dell'immagine ufficiale (sul sito del produttore)

Cuocere la pasta

Far bollire una sufficiente quantità di acqua in una pentola dai bordi alti con un coperchio. Dosare circa 100 gr di pasta per persona. Quando l'acqua arriva a bollore salare con un cucchiaino di sale grosso per ogni 700 ml d'acqua. Buttare la pasta e coprire la pentola finché l'acqua non riprende a bollire, quindi spegnere il fuoco. Cuocere per il tempo indicato a partire dalla ripresa del bollore. Girare con un mestolo un paio di volte durante la cottura. Scolare la pasta, condire a volontà e servire ben calda. L'acqua calda di cottura può essere usata in piccole dosi nel condimento oppure per lavare a mano i piatti.

Avvertenze

I tempi di cottura indicati sono da intendersi per una cottura "al dente" così come raccomandati dai produttori. Per una pasta più morbida al palato aggiungere uno o due minuti secondo il proprio gusto.

Garanzie

Questa applicazione viene fornita così com'è, senza garanzie di alcun tipo, esplicite o implicite. In nessun caso gli autori o i titolari del copyright saranno responsabili per qualsiasi reclamo, danno o altro tipo di responsabilità.

Dati personali

Questa applicazione non raccoglie alcun dato personale dell'utente. L'hosting dell'applicazione è gestito da Github (vedi Github Pages). Il salvataggio dei preferiti avviene sul device dell'utente mediante localStorage.

Copyright

Tutti i marchi registrati e tutte le immagini sono dei rispettivi proprietari e sono residenti sui loro server. L'autore del logo dell'applicazione è monkik di flaticon.com.

Licenze di riutilizzo

Il codice sorgente di questa applicazione è rilasciato in open source con licenza MIT. Il database dei tempi di cottura della pasta (file timers.json) è rilasciato con licenza ODbL.

Contatti

Per segnalare malfunzionamenti, suggerire una modifica o fare una domanda puoi aprire una issue sul repository del progetto su Github.

pasta-timers-app's Issues

Clean useless files from CRA boilerplate

Iphone non funziona lo scroll

Su Iphone iOS 13, sia con Safari che con Chrome, nella webapp non funziona lo scroll.
Anche salvandola nella Home come appunto webapp.

SVG images are not cached

When in offline mode, SVG images (embedded with a simple img tag) are not shown because of a cache issue.

Hints:

• https://stackoverflow.com/a/56927409

README translation in Spanish

Check localization strings

Localization is performed by i18next and strings definitions are in src/locales files.

Improve Info page

• Better text flow with rich formatting, floating images, text justification.
• Paragraphs rearrangement.
• Maybe collapsible titles for a better paragraph navigation.
• ...

Review of copyright notices

Because legal stuff is important and interesting as much as development one.

README translations

If you want translate the README in your language, please open a PR adding a README-[language_id].md file in root directory and update the third line of README.md file accordingly.

• Italiano
• English
• Español
• Português
• 简体中文
• ...

Improve README

• Minimal information and link to info page.
• Complete information about setup of a development environment.
• List of dependencies with links.
• ...

Single page for each timer

Now if the user tap on pasta images he browses away from the app to the official page of producer.

Maybe every pasta can have a page with a bigger picture, some extra informations, timer controls and a link to the external resource.

README translation in English

Real timers with play, stop, reset controls

Development of reliable multiple timers in a PWA can be tricky.

We can use web workers to prevent slowdowns in countdown and show them in multiple components (ie. in timers page, in favorites page, and also in a new page listing running timers).

Some questions:

• do timers keep working also if user switch foreground application?
• can a timer play an audio file when time expires?
• can this alarm be generated on-the-fly (ie. by a service worker) using the pasta id as parameter to have unique sound for each pasta?

Get all pasta times from all producers

Data completeness, correctness and freshness are the biggest issues for data-driven applications.

Three ways to face them:

• talking directly with producers to obtain official data (static files or APIs) released under an open license
• developing scrapers to extract data from official websites and keep them up to date
• handmade crowd-sourcing

All strategies must take into account issue #9 .

We can start listing all Italian pasta producers:

• Barilla
• Garofalo
• De Cecco
• ...

WARNING: if you want to update pasta timers database sending a pull request, please edit public/timers.json and not build/timers.json!

Info page translation in English

Open contest for logo design

Pasta Timers logo is actually a free icon from flaticon.com.

If you are a designer and want to contribute to an amazing open source project, now you can! 😄

Here are the requirements :

• a logo for pasta timers app (SVG format)
• a coordinated color palette

And some rules:

• a single submission has to be a single reply to this issue
• you can submit all proposals you want, but not later than November 30, 2019
• users can vote using Github built-in features (:+1: and :-1: reactions)

Copyright of works remains of the original author. The winner should release his work under an open license, but can withdraw it at any time.