Installatie

Eén prompt.
BankBird draait.

Geen terminal, geen handmatig geklungel. Met Laravel Herd en een AI-assistent zoals Claude of Codex doe je de hele installatie in vier stappen.

⚡

Vier stappen

Van clone tot draaiend, in een paar minuten

🔁

Altijd beschikbaar

Herd start mee met je computer — nooit meer iets opstarten

🐦

bankbird.test

Eigen lokaal adres in je browser, geen poortnummers

✨ AI-installatie assistent

Weinig technische kennis nodig

BankBird bevat een ingebouwd AGENTS.md install-protocol. Open Claude Code of Codex in de project-map en geef onderstaande prompt — de agent doet de rest.

Download Herd

prompt.txt

Installeer BankBird (github.com/AivionStudiosPlayground/bankbird) voor me.

Eén regel volstaat. De agent leest het End-user installation protocol in AGENTS.md en doorloopt zelf alle stappen.

Spring naar: 1️⃣ Herd 2️⃣ Clone 3️⃣ Prompt 4️⃣ Klaar HTTPS (optioneel) Geavanceerd Problemen

Installeer Laravel Herd

Eénmalig — bundelt PHP, Composer en Node, draait op de achtergrond

Herd is een gratis tool van het Laravel-team. Hij installeert alles wat BankBird nodig heeft, en zorgt dat je app altijd op de achtergrond draait op http://bankbird.test — ook na een herstart.

Download Laravel Herd Beschikbaar voor Windows en macOS · Gratis

💡

Geen Herd? Vraag Claude/Codex om hem te installeren — de agent download de installer en je hoeft alleen één keer "Ja" te klikken op de Windows-beveiligingsprompt (UAC).

Clone de repository

Download de broncode op een plek naar keuze

Open een terminal (Herd levert er één mee — of gebruik Windows Terminal / iTerm), navigeer naar waar je BankBird wilt opslaan en run:

bash

git clone --single-branch --branch master --depth 1 https://github.com/AivionStudiosPlayground/bankbird.git
cd bankbird

Vraag Claude of Codex

Eén prompt — de agent doet de rest

Open Claude Code of Codex CLI in de project-map en geef deze prompt:

prompt

Installeer BankBird (github.com/AivionStudiosPlayground/bankbird) voor me.

📜

De agent volgt het End-user installation protocol uit AGENTS.md: Herd-detectie, dependencies installeren, het project aan Herd koppelen (herd link bankbird), database opzetten, admin-account aanmaken en een smoke-test op de loginpagina.

Open je browser

Voor altijd beschikbaar — geen server starten, geen terminal

Zodra de agent meldt dat alles klaar is:

browser

http://bankbird.test/

✨

Klaar voor altijd. Herd start automatisch met je computer. Vanaf nu open je BankBird gewoon in je browser, ook na een herstart. Claude/Codex heb je alleen nog nodig voor updates of hulp bij fouten.

🔒

HTTPS aanzetten (optioneel)

Default draait BankBird op HTTP — voor lokaal gebruik veilig genoeg

Wil je een groen slotje? Run één keer in de project-map:

bash

herd secure

Volg de Windows-prompt om Herd's lokale certificaat te vertrouwen (één UAC-klik). Daarna werkt https://bankbird.test.

🛠

Geavanceerd: handmatige installatie

Voor ontwikkelaars of installs zonder Herd

Wil je elke stap zelf doen? Na git clone:

bash

composer install
composer run setup
php artisan make:filament-user

Zonder Herd start je de dev-server zelf met composer run dev en open je http://127.0.0.1:8000/. Let op: deze server moet je elke keer handmatig starten.

⚠️

Vereisten zonder Herd: PHP 8.4 (8.5 nog niet ondersteund), Composer 2+, Node.js 20+, Git.

🔧

Veelvoorkomende problemen

Loopt het vast? Begin hier

bankbird.test laadt niet

Controleer in de Herd-app onder "Sites" of "bankbird" als geparkeerde site staat. Zo niet, run in de project-map: herd link bankbird.

Vrijwel altijd een PHP-versieprobleem (PHP 8.5 i.p.v. 8.4). Open Herd en zet de PHP-versie voor deze site op 8.4. BankBird ondersteunt PHP 8.5 nog niet.

SSL-foutmelding bij https://bankbird.test

Run herd secure in de project-map en bevestig de Windows-prompt om Herd's lokale certificaat te vertrouwen. Of blijf HTTP gebruiken — voor lokaal gebruik is dat prima.

"localhost" werkt niet (zonder Herd)

Gebruik http://127.0.0.1:8000 in plaats van localhost. Op Windows resolved localhost vaak naar IPv6, terwijl php artisan serve alleen IPv4 luistert.

"Class not found" of Vite-fout

Run composer dump-autoload en npm run build opnieuw. Bij hardnekkige problemen: php artisan optimize:clear.

💬

Kom je er niet uit? Open een issue op GitHub en we helpen je snel verder.