Skip to main content

​
Welcome to Softbee

Softbee is a comprehensive beekeeping management application built with Flutter and Clean Architecture. This guide will help you set up your account and create your first apiary with beehives in minutes.
Softbee allows you to manage multiple apiaries, track beehive health, monitor production, and maintain detailed records of your beekeeping operations.

​
Get started in three steps

1

Create your account

Start by creating your Softbee account with your beekeeping information.
  1. Open the Softbee app on your device
  2. Tap Crear una cuenta (Create an account) on the login page
  3. Fill in your personal information:
    • Full name
    • Email address (e.g., [email protected])
    • Phone number (e.g., 300 123 4567)
    • Password (minimum 8 characters with uppercase, lowercase, number, and special character)
    • Confirm password
Make sure your password meets all requirements shown on the registration form for maximum security.
2

Add your first apiary

After completing personal information, you’ll set up your first apiary location.
  1. On Step 2: Información de Apiarios, fill in the apiary details:
    • Apiary Name: Give it a descriptive name (e.g., “Las Flores Apiary”)
    • Exact Address: Provide the precise location (e.g., “Cota, Vereda El Rosal - Finca La Esperanza”)
    • Treatment Application: Toggle whether you apply treatments when bees are sick
// Example apiary entity structure
class Apiary {
  final String id;
  final String userId;
  final String name;
  final String? location;
  final int? beehivesCount;
  final bool treatments;
  final DateTime? createdAt;
}
  1. (Optional) Click Agregar otro apiario to add additional apiary locations
  2. Click Registrarse to complete registration
Ensure the apiary address is accurate - this information helps you track and manage different locations effectively.
3

Create your first beehive

Once logged in, navigate to your apiary dashboard and add beehives.
  1. From the main dashboard, select your apiary
  2. Navigate to the Hives section
  3. Click the + button to create a new beehive
  4. Fill in the beehive information:
    • Hive Number: Unique identifier (required, e.g., 101)
    • Activity Level: Low, Medium, High, or Very High (optional)
    • Bee Population: Low, Medium, High, or Very High (optional)
    • Food Frames: Number of frames with food reserves (optional)
    • Brood Frames: Number of frames with brood (optional)
    • Hive Status: Active, Inactive, Under Review, or Abandoned (optional)
    • Health Status: Healthy, Sick, Under Treatment, or Critical (optional)
    • Production Chamber: Yes, No, or In Process (optional)
    • Observations: Any additional notes (optional)
// Example beehive creation
const Beehive(
  id: '1',
  apiaryId: 'apiary-123',
  beehiveNumber: 101,
  activityLevel: 'High',
  beePopulation: 'Medium',
  foodFrames: 5,
  broodFrames: 3,
  hiveStatus: 'Active',
  healthStatus: 'Healthy',
  hasProductionChamber: 'Yes',
  observations: 'Strong colony, good honey production',
);
  1. Click Crear Colmena to save
Start with essential information (hive number) and add detailed observations over time as you inspect your hives.

​
What’s next?

Now that you have your first apiary and beehive set up, explore these features:

Manage Beehives

Add beehives to your apiary, track health, and record inspection data.

Monitor Production

View production metrics, health indicators, and performance trends.

Inventory Management

Track your beekeeping equipment, supplies, and honey production.

Managing Apiaries

Learn how to create and manage multiple apiary locations.

Monitor Production

View production metrics, health indicators, and performance trends.

Inventory Management

Track your beekeeping equipment, supplies, and honey production.

View Monitoring

Track inspections and health metrics for your beehives.

​
Key features at a glance

Manage multiple apiary locations from a single dashboard. Each apiary can have unlimited beehives with independent tracking.
Record comprehensive data for each hive including activity levels, population, food stores, brood status, health conditions, and production capabilities.
Built with industry-standard Clean Architecture principles ensuring maintainability, testability, and scalability.
Work seamlessly without internet connection. Data syncs automatically when you’re back online.
Enjoy a professional interface with smooth animations (Lottie), custom theming, and responsive layouts for all devices.
Need help? Check out our detailed Installation Guide for platform-specific setup instructions, or explore the API Reference for development information.

Build docs developers (and LLMs) love

Get started for freeTalk to us