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 / VPS).

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 oma VPS — 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. VPS 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	Oma VPS; 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.	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 Supabase-lokero toimii, jos CORS sallii tämän osoitteen. Tilari-palvelinta ei ole: ei “Palvelimella”-käsittelyä eikä palvelimen kirjalokeroa.

Tiedosto koneella (USB, sähköposti)

Tallenna tilari.html ja avaa kaksoisklikkaamalla.
Valitse Valitse uusi tiedosto… ja etsi .kitsas.
Tallenna Tallenna nimellä… – 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 palvelimelta…)
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ä (Valitse uusi tiedosto…) tai lokerosta (Avaa palvelimelta…).
Chrome- tai Edge-työpöydällä Tallenna kirjoittaa samaan .kitsas-tiedostoon, jos tiedosto on yhdistetty. Muissa selaimissa käytä Tallenna nimellä….

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 palvelimelle.

Jos kaksi ihmistä muokkaa samaa kirjaa yhtä aikaa, toinen tallennus voi estyä (“tiedosto on muuttunut”). Tallenna silloin Tallenna palvelimelle 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.

Oma VPS

Julkinen osoite ja kirjautuminen portilla. Palvelin pitää kirjat lokerossa. Käytä Tilaria tavallisena verkkosovelluksena tai käsittele kirjaa selaimessa ja tallenna lokeroon. Asennus on ylläpitäjän tehtävä; tämä ohje ei korvaa sitä.

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ä	Valitse uusi 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 nimellä….
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 nimellä. Lokero (VPN tai Supabase) on usein helpompi.

Jos selain ei tue suoraa tallennusta, valikossa lukee ohje käyttää Tallenna nimellä…. Voit myös valita Yhdistä alkuperäistiedostoon…, kun tuki on olemassa mutta tiedosto avattiin ilman kirjoitusoikeutta.

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, polku tilari/ (anon-rooli, select / insert / update / delete).
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' and name like 'tilari/%');
create policy "tilari_locker_insert"
  on storage.objects for insert to anon
  with check (bucket_id = 'tilari' and name like 'tilari/%');
create policy "tilari_locker_update"
  on storage.objects for update to anon
  using (bucket_id = 'tilari' and name like 'tilari/%');
create policy "tilari_locker_delete"
  on storage.objects for delete to anon
  using (bucket_id = 'tilari' and name like 'tilari/%');

Yhdistä Tilarissa

Avaa palvelimelta… → Oma Supabase.
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 palvelimelle 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: Valitse uusi tiedosto… → Androidin tiedostovalitsin → Dropbox, Google Drive tai Tiedostot. Tilari lukee tiedoston.
Tallenna: Tallenna nimellä… 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.