Skip to main content
Get your AndanDo tour marketplace running locally in just a few steps.

​
Prerequisites

Before you begin, ensure you have:

.NET SDK 10.0

Download from dotnet.microsoft.com

SQL Server

Local instance or connection to remote server

Git

For cloning the repository

Code Editor

VS Code, Visual Studio, or Rider recommended

​
Quick Setup

1

Clone the Repository

Clone the AndanDo repository to your local machine:
git clone https://github.com/Designa-Studio/AndanDo.git
cd AndanDo/AndanDo
2

Configure Database Connection

Edit appsettings.Development.json with your SQL Server connection:
appsettings.Development.json
{
  "ConnectionStrings": {
    "DefaultConnection": "Server=localhost;Database=AndandoDB;Integrated Security=true;TrustServerCertificate=true;"
  }
}
Replace with your actual SQL Server credentials if not using Windows Authentication.
3

Configure JWT Settings

Update JWT configuration in appsettings.Development.json:
appsettings.Development.json
{
  "Jwt": {
    "Issuer": "AndanDo",
    "Audience": "AndanDo",
    "SecretKey": "your-secret-key-min-32-characters-long",
    "ExpirationMinutes": 120
  }
}
Generate a secure secret key for production. Use at least 32 characters.
4

Restore Dependencies

Restore NuGet packages:
dotnet restore
5

Build the Application

Build the project to ensure everything compiles:
dotnet build
6

Run the Application

Start the Blazor Server application:
dotnet run
The application will be available at:
  • HTTPS: https://localhost:7129
  • HTTP: http://localhost:5004
Use HTTPS for the best experience with secure features like ProtectedLocalStorage.

​
Verify Your Setup

Once the application is running, verify the key features:
Navigate to https://localhost:7129 to see the tour marketplace homepage with featured tours.
  1. Click Sign Up in the navigation
  2. Fill in the registration form with test data
  3. Complete registration and log in
After logging in, access the host dashboard to:
  • View tour statistics
  • Manage bookings
  • Create new tours

​
Optional: Configure External Services

For full functionality, configure these optional services:

SMTP Email

Configure email notifications for bookings

PayPal Payments

Enable payment processing with PayPal

Google Maps

Add your API key for location features

Currency Conversion

Enable multi-currency support

​
Common Issues

If ports 7129 or 5004 are already in use, modify Properties/launchSettings.json:
"applicationUrl": "https://localhost:7130;http://localhost:5005"
Verify:
  • SQL Server is running
  • Connection string is correct
  • Database AndandoDB exists (or will be created)
  • User has proper permissions
Ensure:
  • SecretKey is at least 32 characters
  • Issuer and Audience match in configuration
  • System clock is accurate

​
Next Steps

Now that you have AndanDo running, explore the platform:

Architecture Guide

Understand the system design

Core Features

Explore marketplace capabilities

API Reference

Dive into the service APIs

Host Guide

Learn to create and manage tours

Configuration

Customize your installation

Deployment

Deploy to production
Need help? Check the Installation Guide for detailed setup instructions or visit the Configuration section.

Build docs developers (and LLMs) love

Get started for freeTalk to us