Mitä Tilari on

Tilari on kirjanpito-ohjelma, jota käytät selaimessa. Kirjaat menot, tulot ja siirrot, liität kuitteja, selaat tasetta ja tuloslaskelmaa ja teet tilinpäätöksen. Kirjanpito elää tiedostossa tai lokerossa, jonka sinä hallitset — ei Tilarin pilvitilillä.

Et tarvitse Kitsasta käyttääksesi Tilaria. Voit luoda uuden suomalaisen yrityskirjan suoraan selaimessa ja pitää kirjaa siitä eteenpäin.

Jos käytät jo työpöytä-Kitsasta (avoimen lähdekoodin kirjanpito), tämä versio avaa ja tallentaa saman .kitsas-tiedoston. Tiedoston voi avata vuorotellen kummassa tahansa; myöhempi Tilari voi tästä poiketa. Tilari ei ole Kitsas Oy:n tuote, eikä Kitsas Oy tue sitä.

Aloita kokeilemalla: avaa Tilari, luo kirja, kirjaa tosite. Alla on, mitä ohjelma tekee ja kenelle se sopii. Käyttötavat (HTML, oma kone, lokero) ovat sivun loppupuolella.

Miksi Tilari

Kokeile heti: yksi HTML-tiedosto — käynnistyessä luot uuden kirjan.
Toimii kokonaan selaimessa — tai tavallisena verkkosovelluksena.
Raportit, joista pääsee klikkaamalla tositteeseen; muutosloki istunnossa.
Tilinpäätös onnistuu. Arkistoa ei vielä ole.
Kirja sinun tiedostossasi tai omassa lokerossa (Supabase / Tilari-palvelin).

Mitä Tilari lisää

Tilari on täysi kirjanpito selaimessa, ei pelkkä katselin. Päivittäiseen käyttöön se tuo asioita, joita työpöytäohjelmissa harvoin on samassa muodossa — ja jotka auttavat, vaikka et olisi käyttänyt Kitsasta lainkaan.

Selain ilman asennusta: yksi HTML-tiedosto, paikallinen palvelin tai oma lokero. Voit kokeilla heti ja pitää kirjaa puhelimessa tai USB-tikulla.
Aikanavigointi: Kuukausi / Tilikausi / Kaikki ja edellinen/seuraava raporteissa ja pääkirjassa. Kuukausi kerrallaan on luonteva tapa katsoa, miltä kausi näyttää.
Raportit, joista pääsee perille: taseesta tilille ja tositteeseen, plus kuukausikaaviot (liikevaihto, tulos, verot).
Juokseva saldo pääkirjassa — näet tilin kertymän rivi riviltä.
Muutosloki istunnossa: mitä ehdit muuttaa ennen tallennusta.
Tallenna kun haluat: työ voi pysyä selaimessa; Chromium voi myös kirjoittaa suoraan avattuun tiedostoon.
Valinnainen lokero: oma Supabase (salaus selaimessa) tai Tilari-palvelin — ei Tilarin pilveä.
Linux-, Windows- ja macOS-paketit, jos haluat ohjelman omalle koneelle.

Jos tunnet jo Kitsaksen: nämä ovat asioita, joita työpöytä-Kitsaksessa ei ole samassa muodossa. Työpöytä-Kitsas on edelleen viite ominaisuuksille, joita Tilarissa ei vielä ole (yhdistys ja taloyhtiö, tilikartan muokkain, arkisto). Tässä versiossa sama .kitsas-tiedosto käy molemmissa.

Kenelle

Tilari on hyödyllinen kenelle tahansa, joka haluaa pitää suomalaista kahdenkertaista kirjanpitoa itse: freelancer, toiminimi, pieni osakeyhtiö, tai kirjanpitäjä joka haluaa selaimen eikä erillistä työpöytäohjelmaa. Et tarvitse Kitsas-taustaa — uusi yrityskirja syntyy käynnistyessä.

Erityisen luontevaa se on, jos tunnet jo Kitsaksen: sama tiedosto, samat kirjaussäännöt, selainkäyttöliittymä ja Tilarin omat näkymät (aika, klikkaukset raporteista, muutosloki).

Tekijä on testannut Tilarin omassa käytössä: suomalainen osakeyhtiö ja suhteellisen vähän tositteita (tyypillinen kevytyrittäjä / freelancer). Suuria kirjoja, yhdistystä, asunto-osakeyhtiötä, toiminimeä ja muita ALV-asetuksia ei ole testattu arjessa. Tiedosto todennäköisesti aukeaa; toimintaa niissä ei ole taattu. Kerro, jos käytät Tilaria toisenlaisessa kirjassa — se auttaa priorisoimaan.

Mitä on ja mitä ei

Arjen kirjanpitoon riittää yleensä: avaa tai luo kirja, kirjaa meno / tulo / siirto, liitä kuitti, katso raportit ja tee tilinpäätös. Alla tarkempi lista tästä versiosta. Seuraavaa ei ole aikataulutettu — kerro tarpeesta GitHub Discussionsissa.

Alue	Tila	Huomio
Avaa olemassa oleva `.kitsas`	Mukana
Luo uusi tyhjä kirja	Mukana	Käynnistyessä. Yritystilikartta: nimi, Y-tunnus, ensimmäinen tilikausi, ALV, harjoitus. Yhdistys ja taloyhtiö edelleen työpöytä-Kitsaksessa
Meno / tulo / siirto / muu	Mukana	Päivittäinen kirjaus
Tiliote	Osittain	Muokkaus ja rivin irrotus omaksi tositteeksi. Ei pankkiaineiston tuontia
Liitteet	Osittain	Lataus ja esikatselu. Ei OCR/tulkintaa, ei automaattista kutistusta
Tililuettelo	Ei vielä	Tilikartta luetaan tiedostosta; ei muokkainta
ALV	Osittain	HTML-ilmoitus; ei lähetystä OmaVeroon
Tilinpäätös	Mukana
Arkisto	Ei vielä
Laskutus / kierto / palkat	Ei vielä

Pyydä ominaisuuksia

Tilari kehittyy sen mukaan, mitä oikeasti käytetään. Jos kaipaat puuttuvaa toimintoa (Kitsaksesta tuttua tai uutta ideaa), avaa keskustelu GitHub Discussionsissa. Et tarvitse Kitsas-taustaa: kerro, mitä arjen kirjanpito kaipaa.

Muista

Kirja on sinun tiedostosi. Tallenna. Tilarilla ei ole pilvikopiota puolestasi, ellei lokero ole sinun.
Tallennettu .kitsas-tiedosto on tässä versiossa vaihdettavissa työpöytä-Kitsaksen kanssa. Sulje työpöytä-Kitsas ennen kuin Tilarilla kirjoitetaan samaan polkuun.
Vie Kitsas-työpöydälle kelpaava tiedosto Tilarin tallennuksella (liitteet kootaan tiedostoon). Lokeron sisäinen työkopio voi olla “laiha” eikä aukea Kitsaksessa sellaisenaan.
Tilarissa ei ole laskutusta eikä kiertoa tässä versiossa.

Valitse tapa

Kirja avataan aina selaimessa. Valitse, missä tiedosto asuu ja kuka sitä käyttää.

Yksi HTML Avaa tässä selaimessa, tai lataa USB:lle. Ei asennusta. Omalla koneella Päivittäinen työ. Työkopio säilyy, lokero valinnainen. VPN Muutama laite, ei julkista osoitetta. Supabase Oma pilvilokero ilman Tilari-palvelinta. Tilari-palvelin Julkinen osoite, kirjat omalla palvelimella. Selaimet Mitkä kirjoittavat suoraan samaan tiedostoon. Dropbox / Drive Synkronoitu kansio tai Androidin avaa/tallenna.

Tarkoitus	Käytä
Kokeilu, USB-tikku, ei asennusta	Yksi HTML-tiedosto
Päivittäinen kirjanpito yhdellä koneella	Paikallinen palvelin ja selain
Sama lokero kotona, toimistossa tai puhelimessa, ei julkista sivua	Palvelin VPN-verkossa
Kirja omassa Supabase-projektissa	Supabase-lokero
`.kitsas` Dropbox- tai Drive-kansiossa	Synkronoitu kansio (työpöytä: Chrome/Edge)
Julkinen osoite ja kirjautuminen portilla	Tilari-palvelin; tämä ohje ei korvaa ylläpitäjän asennusta

Kaikissa tavoissa kirja avataan selaimessa. Oletus on Tässä selaimessa: laskenta tapahtuu omalla laitteella. Palvelimella on tarjolla vain, kun Tilari-palvelin on käynnissä (ei Supabase-lokerossa).

Kaksi käsittelytapaa

Voit käyttää Tilaria tavallisena verkkosovelluksena (jokainen toiminto on pyyntö palvelimelle) tai paikallisesti selaimessa ja tallentaa kun haluat. Käyttöliittymä on aina selaimessa. Kun Tilari-palvelin (Node) on yhteydessä, kirjaa avatessa kysytään:

Tässä selaimessa (oletus) — asiakaspuoli: sqlite pyörii tässä välilehdessä. Palvelin voi silti säilyttää tiedostoa lokerossa, mutta se ei avaa tositteita.
Palvelimella — palvelinpuoli: sama laskenta ajetaan Node-prosessissa. Joka klikkaus menee rajapintaan.

Ilman Node-palvelinta (yksi HTML, tämä sivusto, Supabase-lokero) on vain Tässä selaimessa. Lokero (missä tiedosto asuu) ei ole sama asia kuin käsittelytapa: voit pitää kirjaa palvelimen lokerossa ja silti laskea sen selaimessa.

	Tässä selaimessa	Palvelimella
Hyvä puoli	Kirja tulkitaan vain tässä välilehdessä. Useampi välilehti tai henkilö voi avata kirjoja (lokeron tallennus käyttää ETag-ristiriitoja). Toimii, kun tiedosto on jo välilehdessä, vaikka verkko katkeaisi. Palvelimen uudelleenkäynnistys ei pyyhi työkopiota. Sama kirja ei aukea kahteen välilehteen samassa selaimessa. Ladattu kopio ei tallenna lokeron kirjaa: käytä Tallenna säilytykseen.	Raskas kirja ja heikko puhelin: sqlite siirtyy palvelimelle. Sama laskentasäännöstö kuin selaimessa. Uudelleenavaaminen voi olla nopeampaa, kun prosessilla on jo istunto.
Huono puoli	Iso kirja heikossa laitteessa voi olla hidas. Koko kirja ladataan selaimeen. Tallentamattomat muutokset ovat tässä välilehdessä, kunnes tallennat.	Yksi avoin kirja per palvelin. Toinen avaus korvaa ensimmäisen — ei yhteiskäyttöä. Jokainen toimenpide tarvitsee verkon. Palvelimen restart tyhjää istunnon. Palvelin näkee kirjanpidon. Ei toimi Supabase-lokerossa.

Arjen kirjanpitoon ja jaettuun lokeroon: pidä Tässä selaimessa. Palvelimella on yhdelle käyttäjälle, yksityiselle koneelle, kun kirja on liian raskas laitteelle.

Yksi HTML-tiedosto

Sama ohjelma yhtenä tiedostona (noin 1,7 Mt). Tällä sivustolla se on tilari.html — avaa se tästä. Voit myös tallentaa tiedoston ja avata sen ilman verkkoa.

Tässä osoitteessa (https)

Selain pitää sivua luotettavana: työkopio säilyy päivityksen yli, Chrome/Edge voi tallentaa suoraan tiedostoon, ja valinnainen BYO-säilytys toimii, kun yhdistät oman Supabase-projektisi tai Tilari-lokeron omalla Tilari-palvelimella (CORS-sallittava tästä osoitteesta). Tilarin sivusto ei säilytä kirjoja: tiedostoa ei lähetetä mihinkään palvelimeen, jota et itse anna. Samassa osoitteessa ei ole Nodea, joten “Palvelimella”-käsittelyä ei ole.

Tiedosto koneella (USB, sähköposti)

Tallenna tilari.html ja avaa kaksoisklikkaamalla.
Valitse Avaa tiedosto… ja etsi .kitsas.
Tallenna Tallenna tiedostoksi… – selain lataa uuden tiedoston.

file://-osoitteessa työkopio ei yleensä säily sivun päivityksen yli, suora ylikirjoitus epäonnistuu, eikä salausta (Supabase) voi luottaa. Sopii esittelyyn. Varsinaiseen kirjanpitoon valitse paikallinen asennus tai avaa https-versio.

Palvelin ja selain omalla koneella

Tämä on suositeltu tapa yhdelle koneelle: Tilari-ohjelma (AppImage, Tilari.exe, Tilari.app tai ylläpitäjän käynnistämä paikallinen palvelin) avaa selaimen osoitteeseen http://127.0.0.1:8000.

Mitä etua on verrattuna pelkkään HTML-tiedostoon?

	Yksi HTML	Palvelin omalla koneella
Muutokset säilyvät sivun päivityksen yli	Ei	Kyllä (selaimen työkopio)
Tallenna suoraan avattuun tiedostoon	Harvoin	Kyllä Chrome/Edge-työpöydällä
Kirjat Tilari-lokerossa tällä koneella	Ei	Kyllä (Avaa omasta säilytyksestä…)
Raskas kirja: käsittely palvelimella	Ei	Kyllä, jos valitset Palvelimella
Sama kirja puhelimesta samassa Wi-Fi-verkossa	Ei	Kyllä, jos palvelin kuuntelee lähiverkkoa
Asennus	Yksi tiedosto	Ohjelmapaketti

Näin käytät

Käynnistä Tilari. Selain aukeaa itsestään.
Avaa kirja levyltä (Avaa tiedosto…) tai lokerosta (Avaa omasta säilytyksestä…).
Chrome- tai Edge-työpöydällä Tallenna kirjoittaa samaan .kitsas-tiedostoon, jos tiedosto on yhdistetty. Muissa selaimissa käytä Tallenna tiedostoksi….

Sulje työpöytä-Kitsas ennen kuin avaat saman tiedoston Tilarissa. Kitsas pitää tiedostoa lukittuna.

Palvelin ja selain VPN-verkossa

Sama ohjelma kuin omalla koneella, mutta se pyörii koneella, joka on VPN-verkossa (Tailscale, WireGuard, yrityksen VPN). Muut VPN-laitteet avaavat selaimessa sen osoitteen, esimerkiksi http://100.x.x.x:8000. Julkista verkkosivua ei tarvita.

Tilarissa ei ole käyttäjätunnuksia. Jokainen, joka pääsee osoitteeseen, näkee lokeron kirjat ja voi tallentaa niihin. VPN-jäsenyys on käyttöoikeus. Älä jaa osoitetta avoimeen Wi-Fi-verkkoon.

Ylläpitäjälle

Asenna Tilari aina päällä olevalle koneelle (NAS, kotipalvelin, työasema).
Liitä kone samaan VPN-verkkoon kuin käyttäjien laitteet.
Käynnistä palvelin niin, että se kuuntelee VPN-osoitetta (lähiverkkoon sitominen, esim. --lan, tulostaa TILARI_LAN_URL=).
Avaa osoite muilla laitteilla. Kirjat ovat tuon koneen lokerossa; tallenna Tallenna säilytykseen.

Jos kaksi ihmistä muokkaa samaa kirjaa yhtä aikaa, toinen tallennus voi estyä (“tiedosto on muuttunut”). Tallenna silloin Tallenna säilytykseen nimellä… äläkä ylikirjoita toisen työtä.

“Palvelimella”-käsittely pitää kirjan auki vain yhdelle käyttäjälle kerrallaan. Toimistossa pidä oletus Tässä selaimessa ja jaa kirja lokeron kautta.

Tilari-palvelin

Tilari-palvelin on Node-prosessi, joka tarjoilee käyttöliittymän ja valinnaisen lokeron kirjoille. Sama ohjelmisto toimii tällä koneella (127.0.0.1), lähiverkossa/NAS:lla, VPN:llä tai julkisella VPS:llä — yhdistät URL:lla. Käytä Tilaria tavallisena verkkosovelluksena tai käsittele kirjaa selaimessa ja tallenna lokeroon. Julkinen osoite ja kirjautumisportti ovat valinnaisia ylläpidon valintoja; tämä ohje ei korvaa asennusta.

Mitkä selaimet tallentavat suoraan tiedostoon

Tallenna yläpalkissa yrittää kirjoittaa samaan tiedostoon, jonka avasit. Se onnistuu vain osassa selaimia, ja vain kun sivu on https:// tai localhost (ei pelkkä HTML-tiedosto).

Selain	Suoraan samaan tiedostoon	Käytännössä
Chrome, Edge, Opera, Brave (Windows, macOS, Linux)	Kyllä	Avaa tiedosto… yhdistää tiedoston. Tallenna päivittää sen. Dropbox-kansio toimii, jos se on oikea kansio levyllä.
Firefox	Ei	Työkopio selaimessa säilyy. Levyllä käytä Tallenna tiedostoksi….
Safari (Mac, iPhone, iPad)	Ei	Sama kuin Firefox: lataa kopio.
Chrome Androidissa	Ei luotettavasti	Avaa Dropboxista tai Drivesta Androidin tiedostovalitsimella. Tallennus on kopio (Lataukset tai “Tallenna sijaintiin”).
iPhone / iPad, muut selaimet	Ei	Jaa tai Tallenna tiedostoksi. Lokero (VPN tai Supabase) on usein helpompi.

Jos selain ei osaa kirjoittaa suoraan tiedostoon, käytä Tallenna tiedostoksi…. Yhdistä alkuperäistiedostoon… näkyy valikossa vain, kun selain tukee sitä ja kirja avattiin ilman kirjoitusoikeutta.

Kirjanpitotiedosto-valikossa on ensin Luo uusi kirja… ja sitten ryhmät Avoin kirja (sulje tai hylkää muutokset), Tämä laite (tiedostot tällä koneella) ja Oma säilytys (oma Tilari-palvelin tai Supabase). Viimeksi avatut kirjat ovat sen ryhmän alla, josta ne avattiin. Chromessa ja Edgessä tiedosto avautuu viimeisimmistä suoraan (selain voi kysyä luvan); muissa selaimissa Tilari pyytää valitsemaan tiedoston uudelleen.

Supabase lokerona

Voit pitää kirjat omassa Supabase-projektissa. Tilari-palvelinta ei tarvita: avaat Tilarin staattiselta sivulta (tai paikallisesta asennuksesta) ja yhdistät lokeron selaimessa. Laskenta pysyy Tässä selaimessa. Valintaa Palvelimella ei ole.

Kertaluonteinen valmistelu (Supabase-konsoli)

Luo projekti osoitteessa supabase.com ja avaa Project Settings → API.
Kopioi Project URL ja anon public -avain. Älä koskaan liitä service_role-avainta Tilarin – se kuuluu vain palvelimelle.
Luo Storageyn yksityinen bucket nimeltä tilari (ei public CDN).
Storage-käytännöt (RLS) bucketille tilari (anon-rooli, select / insert / update / delete). Polku tilari/book1 rajaa avaimet etuliitteeseen book1/ — lisää silloin name like 'book1/%'.
Storage CORS: Tilarin https-osoite, menetelmät GET, POST, PUT, DELETE, otsikot authorization, apikey, content-type, x-upsert. Pelkkä file://-HTML ei toimi luotettavasti.

Esimerkki RLS-käytännöistä:

create policy "tilari_locker_select"
  on storage.objects for select to anon
  using (bucket_id = 'tilari');
create policy "tilari_locker_insert"
  on storage.objects for insert to anon
  with check (bucket_id = 'tilari');
create policy "tilari_locker_update"
  on storage.objects for update to anon
  using (bucket_id = 'tilari');
create policy "tilari_locker_delete"
  on storage.objects for delete to anon
  using (bucket_id = 'tilari');

Yhdistä Tilarissa

Avaa omasta säilytyksestä… → Oma Supabase (BYO).
Liitä Project URL, anon-avain, bucket (oletus tilari) ja salaava avain (vähintään 8 merkkiä). Voit luoda avaimen Luo-painikkeella – tallenna se muualle heti.
Yhdistä. Kirjat näkyvät listassa; tallenna säilytykseen kuten muutenkin.

Tiedostot salataan selaimessa ennen lähetystä. URL ja anon-avain avaavat bucketin; salaava avain avaa tiedostot. Jos avain katoaa, kirjoja ei voi palauttaa. Tiedot ovat vain tässä selainvälilehdessä; sulje välilehti, niin yhteys katkeaa.

Dropbox-kansio ja Android (Drive / Dropbox)

Työpöytä: asennettu Dropbox tai Google Drive

Tilarilla ei ole Dropbox- tai Drive-kirjautumista. Käytä kansiota, jonka työpöytäsovellus synkronoi levylle.

Asenna Dropbox tai Google Drive niin, että kirjanpito on oikea kansio koneella.
Avaa kirja Chromella tai Edgellä tuosta kansiosta, jotta Tallenna kirjoittaa samaan tiedostoon.
Synkronointi vie uuden version muihin laitteisiin.

Firefox ja Safari lataavat kopion: siirrä se itse synkronoituun kansioon, muuten syntyy rinnakkaisia tiedostoja. Älä pidä työpöytä-Kitsasta auki samaan tiedostoon. Jos kaksi ihmistä tallentaa yhtä aikaa, pilvipalvelin pitää viimeisen version – Tilarin lokeron ristiriitavaroitusta ei ole.

Android: avaa ja tallenna Dropboxista tai Drivesta

Puhelimessa ei ole samaa “kirjoita suoraan tiedostoon” -yhteyttä kuin Chrome-työpöydällä.

Avaa: Avaa tiedosto… → Androidin tiedostovalitsin → Dropbox, Google Drive tai Tiedostot. Tilari lukee tiedoston.
Tallenna: Tallenna tiedostoksi… vie kopion Lataukset-kansioon tai selaimen sijaintivalintaan. Lataa se sieltä Driveen tai Dropboxiin, tai valitse järjestelmän “Tallenna sijaintiin”, jos selain sen näyttää.

Jos sama kirja kiertää puhelimen ja tietokoneen välillä jatkuvasti, VPN-lokero tai Supabase on vähemmän virhealtis kuin Lataukset-kansio.