BankBird
Aan de slag →
🚀 Installatie handleiding

In vijf minuten
klaar voor gebruik

Geen zorgen, BankBird is makkelijk te installeren. Volg de stappen hieronder en je bent zo aan de slag.

BankBird installatie
🛠️
Nieuw met Vibe Coding? Zorg eerst dat je Claude Code of ChatGPT hebt en maak een lege projectmap aan.
Lees de voorbereiding →
✨ Nieuw: AI-installatie assistent

Geen technische kennis nodig 🐦

Kopieer de onderstaande prompt en plak hem in Claude of ChatGPT. De AI begeleidt je stap voor stap door de volledige installatie — op Windows, Mac of Linux.

BankBird installatie
installatie-prompt.txt 
Je bent een vriendelijke installatie-assistent voor BankBird 🐦
BankBird is een open-source persoonlijke financiële administratie app (Laravel 11 + Filament 5).

Jouw taak: begeleid mij stap voor stap door de installatie op mijn computer.
Ga ervan uit dat ik weinig technische kennis heb. Wees geduldig en bemoedigend.

Repo: https://github.com/AivionStudiosPlayground/bankbird

WAT BANKBIRD DOET:
- Bankafschriften importeren (ING PDF en CSV — Rabobank & ABN AMRO volgen binnenkort)
- Transacties automatisch categoriseren via AI (Claude of OpenAI) — optioneel
- Slimme merchant-herkenning via patronen
- Mooie financiële rapporten en overzichten
- Multi-user ondersteuning met 2FA

AANPAK:
1. Vraag eerst naar mijn besturingssysteem (Windows / Mac / Linux)
2. Controleer of de vereisten aanwezig zijn (PHP 8.2+, Composer, Node.js 18+, Git)
3. Help bij het installeren van ontbrekende vereisten
4. Begeleid door: clone → composer install → npm install → .env instellen
5. Stel SQLite voor als database (makkelijkste optie voor beginners)
6. Voer migrations uit, bouw frontend, start de app
7. Help bij eventuele fouten

REGELS:
- Geef slechts één stap/commando tegelijk
- Wacht op mijn bevestiging/output voordat je verdergaat
- Leg elk commando kort uit in gewone taal
- Als er een fout is, help dan troubleshooten vóór je verder gaat
- Stel aan het einde voor om AI-categorisatie in te stellen (optioneel)

Begin met een vriendelijke begroeting en vraag naar mijn besturingssysteem!
Spring naar: 📋 Vereisten ⬇️ Installatie ⚙️ Configuratie ▶️ Opstarten 🤖 AI instellen 🔧 Problemen
1

📋 Vereisten

Zorg dat je dit hebt geïnstalleerd

⚙️
PHP 8.2+
Of hoger
🐘
Composer
v2+
🟢
Node.js
v18+
🗄️
MySQL of SQLite
Database
📦
Git
Voor clonen
🔑
API key
OpenAI of Anthropic (optioneel)
2

⬇️ Repository clonen

Download de broncode

bash 
# Clone de repository
git clone https://github.com/AivionStudiosPlayground/bankbird.git
cd bankbird

# Installeer PHP dependencies
composer install

# Installeer Node dependencies
npm install
3

⚙️ Omgeving instellen

Kopieer en bewerk het configuratiebestand

bash 
cp .env.example .env
php artisan key:generate

Pas vervolgens je .env bestand aan met jouw database-gegevens:

.env 
# Database (MySQL voorbeeld)
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=bankbird
DB_USERNAME=root
DB_PASSWORD=jouw_wachtwoord

# Of gebruik SQLite (makkelijkste optie)
DB_CONNECTION=sqlite
4

▶️ Database & opstarten

Maak de tabellen aan en start de app

bash 
# Database aanmaken en seeden
php artisan migrate --seed

# Frontend assets bouwen
npm run build

# Development server starten
php artisan serve
🎉
Je bent klaar! Open http://localhost:8000 in je browser. Log in met de standaard credentials uit de seeder.
5

🤖 AI categorisatie instellen (optioneel)

Laat AI je transacties automatisch categoriseren

.env 
# Kies je AI provider
AI_PROVIDER=anthropic  # of: openai

# Anthropic (Claude)
ANTHROPIC_API_KEY=sk-ant-...

# Of OpenAI (GPT)
OPENAI_API_KEY=sk-...
💡
Tip: AI is optioneel. Zonder API key kun je transacties ook handmatig of via merchant-patronen categoriseren. Beide werken prima!
🔧

Veelvoorkomende problemen

Loopt het vast? Hier de meestgestelde vragen

❓ Geen verbinding met database
Controleer je DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME en DB_PASSWORD in .env. Bij SQLite hoef je alleen DB_CONNECTION=sqlite in te stellen.
❓ Vite fout bij npm run build
Zorg dat je Node.js v18 of hoger hebt. Probeer eerst `npm install` opnieuw uit te voeren.
❓ AI categorisatie werkt niet
Controleer of je API key correct is ingesteld in .env en of je voldoende credits hebt bij je AI provider.
❓ Pagina laadt niet na installatie
Voer `php artisan config:clear && php artisan cache:clear` uit om de cache te legen.
💬
Kom je er niet uit? Open een issue op GitHub en we helpen je snel verder!