🌋 Bókun Katla: The AI-Powered App Store Starter Kit

Welcome to Katla, the official boilerplate for building custom applications for the Bókun App Store.

Whether you are a tour operator with a great idea or a seasoned developer looking to skip the boilerplate, Katla is designed to help you build production-ready apps at lightning speed using AI. We have pre-configured this repository with Spec Kit, meaning your AI assistant already knows Bókun's API, security rules, and OAuth requirements.

You don't need to write the code. You just need to direct the AI.

---

🛠️ Prerequisites

Before you start, make sure you have the following installed:

1. Git (to clone this repository)
2. An AI Coding Assistant (We recommend Cursor or Claude Code)
3. ngrok (to expose your local app to Bókun for testing: Download here)
4. A Bókun Partner Account (to register and test your app)

---

🚀 Getting Started

Step 1: Clone the Repository

Open your terminal and clone Katla to your local machine:

git clone https://github.com/bokun/katla.git my-bokun-app
cd my-bokun-app

Step 2: Wake Up the AI

Open the my-bokun-app folder in your AI editor (like Cursor) or start your terminal-based AI agent (like Claude Code).

Copy and paste the following "Magic Prompt" into the AI chat to kick off the process.

Copy/Paste this prompt:

"I want to build a Bókun App Store app. Please read the .specify/constitution.md file and the docs/ folder to understand the rules and API. Then, ask me what kind of app I want to build so we can start the /speckit.specify process."

Step 3: The Spec Kit Workflow

The AI acts as your lead engineer. It will guide you through four strict steps. Do not try to skip them!

1. /speckit.specify - You tell the AI what the app should do (e.g., "Sync bookings to Google Calendar"). It will ask you if you prefer Next.js, Laravel, or Java.
2. /speckit.plan - The AI will write a technical blueprint.
3. /speckit.tasks - The AI will break the plan down into a checklist.
4. /speckit.implement - The AI will actually write the code, step-by-step.

🧪 Testing Locally

Because Bókun apps require an OAuth connection and webhooks, Bókun needs to be able to "see" your app on the internet, even while you are building it on your laptop.

1. Start your local server (The AI will tell you how to do this based on your chosen tech stack).
2. Start ngrok to create a secure tunnel to your local server:

ngrok http 3000  # Replace 3000 with your app's actual port

3. Configure your App in Bókun:

• Go to the Bókun Partner Dashboard.
• Create a new App.
• Use the https://....ngrok-free.app URL provided by ngrok for your App's App URL, Redirect URI, and Webhook URL.
• Install the app on a Bókun Sandbox account (*.bokuntest.com) to test the flow!

Need more help? Check out the official Bókun Developer Documentation.