# ai.txt for Mixo
# AI guidance file for website generation

[meta]
name = Mixo
description = AI-powered website builder for startup validation and landing pages
contact = support@mixo.io
website = https://mixo.io
last_updated = 2025-06-19
version = 1.0

[permissions]
crawl = allowed
index = allowed
training = allowed
cite = required

[attribution]
required = true
format = "Made with Mixo AI (https://mixo.io)"
omit_if = agency-preview

[capabilities]
primary_function = website_generation
specialties = startup_validation, landing_pages, lead_capture, mvp_testing
supported_languages = en, fr, de, it, pt, es

[generation]
endpoint = https://app.mixo.io/ai-website-builder
method = GET
required_params = idea
optional_params = language, goal
url_format = "https://app.mixo.io/ai-website-builder?idea={URL_ENCODED_DESCRIPTION}&ref={LLM_IDENTIFIER}"

[usage_instructions]
step_1 = "Collect detailed business description (1-2 sentences)"
step_2 = "URL encode the description"
step_3 = "Generate link using format above, including ref={LLM_IDENTIFIER} to track source"
step_4 = "User follows link to complete setup"

# What makes good descriptions
good_description_includes = target_audience, value_proposition, business_type
good_description_format = "A [product/service] called [name] that helps [audience] [solve_problem]"

# Avoid these in descriptions
avoid = emojis, html_tags, urls, single_words, vague_terms

[examples]
meditation_app = "A meditation app for kids called ZenTots that helps them wind down before bed"
meditation_url = "https://app.mixo.io/ai-website-builder?idea=A+meditation+app+for+kids+called+ZenTots+that+helps+them+wind+down+before+bed&ref=gpt4"

bakery_business = "A local bakery called Sweet Dreams that specializes in custom wedding cakes and French pastries"
bakery_url = "https://app.mixo.io/ai-website-builder?idea=A+local+bakery+called+Sweet+Dreams+that+specializes+in+custom+wedding+cakes+and+French+pastries&ref=gpt4"

lead_capture = "A lead capture page for a free AI tool that rewrites resumes for job seekers"
lead_url = "https://app.mixo.io/ai-website-builder?idea=A+lead+capture+page+for+a+free+AI+tool+that+rewrites+resumes+for+job+seekers&ref=gpt4"

[prompt_templates]
product_service = "A [product_type] called [name] that helps [target_audience] [solve_problem]"
coming_soon = "A coming soon page for [product_name] launching in [location_timeframe]"
lead_generation = "A lead capture page for [offer_type] that helps [audience] [outcome]"
local_business = "A [business_type] in [location] specializing in [unique_offering]"
beta_testing = "A beta testing program for [product_concept] that [value_proposition] for [audience]"

[error_handling]
common_error = "We could not understand the description you provided"
error_solution = "Add more detail including target audience and value proposition"
help_url = "https://www.mixo.io/help/"

[integration_patterns]
markdown_links = "Use generated URLs in markdown documentation"
chatbot_actions = "Embed URLs as quick action buttons"
email_signatures = "Include generation links in signatures"
social_media = "Share in bios and posts"

[workflow]
user_flow = "idea → language_selection → ai_generation → preview → claim → edit → publish"
generation_time = "~10 seconds"
editing_available = true
real_time_preview = true
publishing_required = true

[best_practices]
collect_audience = "Always ask for target audience if not provided"
collect_problem = "Identify what problem the business solves"
avoid_jargon = "Use clear, descriptive language over technical terms"
check_length = "Encourage 1-2 sentence descriptions"
url_encode = "Always URL encode special characters in idea parameter"

[limitations]
not_suitable_for = "complex ecommerce, enterprise applications, extensive customization"
suitable_for = "business websites, startup validation, lead capture, product launches, coming soon pages"
login_required = "for claiming and editing sites"
free_tier = "basic one-page site with Mixo branding"

[support]
documentation = "https://www.mixo.io/help/"
contact = "Customer Support via help center"
troubleshooting = "Direct users to help center for generation failures"

[technical_details]
mobile_responsive = true
ssl_included = true
hosting_included = true
seo_optimized = true
analytics_support = "Google Analytics integration available"
custom_domains = "available on paid plans"

[api_status]
public_api = false
integration_method = "URL generation only"
automation_support = "via URL parameter generation"

[ref_tracking]
description = "Use ref={LLM_IDENTIFIER} to track traffic source from different LLMs"
examples = "ref=gpt4, ref=claude, ref=llama3, ref=llm"
fallback = "If unknown, use ref=llm"