Skip to main content
Get LarpLand up and running on your machine in just a few minutes.

​
Prerequisites

Before you begin, ensure you have:
  • Flutter SDK installed (3.3.0 or higher)
  • A Firebase account
  • Git installed
  • Your preferred code editor

​
Quick Setup

1

Clone and Install

Clone the repository and install dependencies:
git clone https://github.com/jjimealf/frontendLarpLand.git
cd frontendLarpLand
flutter pub get
2

Configure Firebase

Set up your Firebase project:
  1. Create a new Firebase project at Firebase Console
  2. Enable Authentication (Email/Password), Cloud Firestore, and Firebase Storage
  3. Run FlutterFire CLI to auto-configure:
dart pub global activate flutterfire_cli
flutterfire configure
See the Firebase Setup guide for detailed configuration steps.
3

Run the Application

Launch LarpLand on your preferred platform:
flutter run -d ios

​
First Launch

When you first launch LarpLand, you’ll see the login screen.

​
Create Your Account

1

Navigate to Registration

Tap the Register or Create Account button on the login screen.
2

Fill in Your Details

Enter your:
  • Name
  • Email address
  • Password (minimum requirements apply)
3

Complete Registration

Submit the form. Your account will be created with User role (rol=0) by default.

​
Explore the App

Once logged in, you’ll see the main interface with three sections:

Products

Browse the product catalog, search items, and add to cart

Events

Discover LARP events and register for upcoming sessions

Profile

View your profile, orders, and manage your cart

​
User Flows

​
As a Regular User

1

Browse Products

Navigate to the Products tab and browse available items for your LARP adventures.
2

Add to Cart

Tap products to view details, then add items to your shopping cart.
3

Checkout

Go to your cart, review items, and complete the checkout process.
4

Register for Events

Switch to the Events tab to find and register for upcoming LARP events.

​
As an Admin User

To test admin features, you’ll need to manually update your user’s rol field in Firestore to 1.
Admin privileges should only be granted to trusted users who need to manage products, events, and orders.
Once you have admin access:
1

Access Admin Panel

Log in with your admin account to see the admin dashboard.
2

Manage Products

Add, edit, or remove products from the catalog with image uploads.
3

Manage Events

Create and manage LARP events, track registrations.
4

View Orders & Users

Monitor orders and view the user list.

​
Next Steps

Now that you have LarpLand running, explore these topics:

Features Overview

Learn about all the features LarpLand offers

Architecture

Understand how LarpLand is built

Firebase Backend

Dive into the Firebase integration

Admin Guide

Learn how to manage the platform

​
Development Tips

​
Hot Reload

Flutter supports hot reload for instant updates:
  • Press r in the terminal to hot reload
  • Press R to hot restart
  • Press q to quit

​
Selecting a Device

List all available devices: 
flutter devices
Run on a specific device: 
flutter run -d <device-id>

​
Debug Mode Features

While running in debug mode, you can:
  • View detailed logs in the console
  • Use Flutter DevTools for debugging
  • Inspect widget trees and performance
  • Monitor network requests to Firebase

​
Troubleshooting

If you see “Firebase no configurado” on launch:
  1. Ensure lib/firebase_options.dart is properly configured
  2. Run flutterfire configure again
  3. Add platform-specific config files:
    • android/app/google-services.json for Android
    • ios/Runner/GoogleService-Info.plist for iOS
  4. Restart the app
Check that:
  1. Firebase Authentication is enabled in Firebase Console
  2. Email/Password sign-in method is enabled
  3. Your internet connection is active
  4. Firestore security rules allow user creation
Admin access requires setting rol: 1 in Firestore:
  1. Open Firebase Console → Firestore Database
  2. Navigate to the users collection
  3. Find your user document
  4. Edit the rol field to 1
  5. Log out and log back in
If product images don’t appear:
  1. Verify Firebase Storage is enabled
  2. Check Storage security rules allow read access
  3. Ensure image URLs in Firestore are valid
  4. Check your network connection
For detailed installation and configuration instructions, see the Installation and Firebase Setup guides.

Build docs developers (and LLMs) love

Get started for freeTalk to us