# Hercules

## Docs

- [Agent Modes](https://hercules.app/docs/ai/agent-modes.md): Plan, Debug, and Build modes optimize Hercules for specific tasks. Plan for large features, Debug for bugs, Build for general use.
- [How Hercules AI Agents Work](https://hercules.app/docs/ai/how-it-works.md): Hercules AI reads/writes code, searches the web, generates images, and more. Learn agent modes, multi-agent, and how to improve accuracy.
- [Make Hercules more accurate](https://hercules.app/docs/ai/improve-accuracy.md): Four tips to improve Hercules AI accuracy: new chats per task, Plan/Debug modes, capture tools, and outcome-focused prompts.
- [Multi-Agent](https://hercules.app/docs/ai/multi-agent.md): Run multiple AI agents at once. Create new agents for parallel work, cleaner context, and better accuracy.
- [Hercules AI Gateway](https://hercules.app/docs/apps/ai-gateway.md): Add AI to your app: chatbots, content generation, summarization. OpenAI, Anthropic, Google models. No API keys needed.
- [Analytics](https://hercules.app/docs/apps/analytics.md): Built-in analytics for page views, unique visitors, popular pages, referrals. No setup. Works on published apps.
- [Backend](https://hercules.app/docs/apps/backend.md): Serverless backend with API routes, database access, scheduled functions, cron jobs. Scales automatically.
- [Branding & SEO](https://hercules.app/docs/apps/branding-seo.md): Customize browser tab, login branding, Open Graph images, and theme. Built-in SEO tools for discoverability.
- [Capture Tools](https://hercules.app/docs/apps/capture-tools.md): Screenshot, annotate, screen record, and select elements to give Hercules precise visual context for changes.
- [Code Editor](https://hercules.app/docs/apps/code-editor.md): View and edit app code from the Codebase tab. Manual edits for precise control. Prefer Hercules AI for most changes.
- [Compliance](https://hercules.app/docs/apps/commerce/compliance.md): Verify identity and business before accepting payments. KYC, bank account, and Stripe verification.
- [Coupons](https://hercules.app/docs/apps/commerce/coupons.md): Create discount codes for promotions. Set percentage or fixed discounts with usage limits and expiration.
- [Customers](https://hercules.app/docs/apps/commerce/customers.md): View and manage commerce customers. See purchase history, entitlements, refunds, and manually grant access.
- [Hercules Commerce](https://hercules.app/docs/apps/commerce/get-started.md): Accept payments in your app. Sell SaaS, digital products, physical goods, services, events, memberships, and donations.
- [Integrate Into My App](https://hercules.app/docs/apps/commerce/integrate-into-my-app.md): Example prompts to integrate Hercules Commerce into your app. SaaS, eCommerce, events, digital products, services, donations.
- [Other Settings](https://hercules.app/docs/apps/commerce/other-settings.md): Configure statement descriptors, tax, subscription changes, and payment entities for Hercules Commerce.
- [Payouts](https://hercules.app/docs/apps/commerce/payouts.md): Track earnings transfers to your bank. View pending amounts, payout history, and fee breakdowns.
- [Products & Features](https://hercules.app/docs/apps/commerce/products-features.md): Define products, variants, and features in Hercules Commerce. Create SaaS plans, physical goods, digital products, and more.
- [Hercules Commerce Support](https://hercules.app/docs/apps/commerce/support.md): Get help with Hercules Commerce. Report issues in-app and select Hercules Commerce for priority support.
- [Testing Hercules Commerce](https://hercules.app/docs/apps/commerce/testing.md): Test Hercules Commerce in preview or on a published app. Production-only; test with real card then refund.
- [Transactions](https://hercules.app/docs/apps/commerce/transactions.md): Track payments, refunds, and disputes. Monitor revenue and handle issues from Commerce → Transactions.
- [Database](https://hercules.app/docs/apps/database.md): Every app includes a database. Hercules creates schema from your descriptions. View, edit, import from the Database tab.
- [Dev Machines](https://hercules.app/docs/apps/dev-machines.md): Temporary servers for building and testing. Restart if issues. Published apps run separately.
- [Hercules Email](https://hercules.app/docs/apps/emails.md): Send emails from your app. Verify email or domain. Welcome emails, invoices, order confirmations, and more.
- [Environments](https://hercules.app/docs/apps/environments.md): Run your app in separate production and development environments. Add development deployments with their own database, functions, and secrets to test changes safely.
- [Hercules Files & Media](https://hercules.app/docs/apps/files-media-storage.md): Store images, videos, PDFs with CDN URLs. Upload, integrate into your app, and use image transformations.
- [Hercules AI Image Generation](https://hercules.app/docs/apps/image-generation.md): Generate logos, illustrations, product images, and banners with Hercules AI. Any style: photorealistic, flat, pixel art.
- [Internationalization](https://hercules.app/docs/apps/internationalization.md): Add multi-language support. Language switcher, locale URLs, RTL support. Support 100+ languages.
- [Mobile Apps](https://hercules.app/docs/apps/mobile/get-started.md): Build mobile apps with Hercules. Publish to App Store, Google Play, or as PWA. Push notifications, camera, location.
- [Publish Your App](https://hercules.app/docs/apps/mobile/publish-app-store.md): Publish to App Store, Google Play, Microsoft Store, or as PWA. Use PWA Builder to generate store packages.
- [Test Your Mobile App](https://hercules.app/docs/apps/mobile/test-mobile.md): Test mobile apps by publishing to a Hercules domain, then installing on your device with Add to Home Screen.
- [Update Your App](https://hercules.app/docs/apps/mobile/update-mobile-app.md): Update mobile apps by publishing in Hercules. Content updates are instant; metadata changes require store resubmission.
- [Buy a domain in Hercules](https://hercules.app/docs/apps/publish/buy-domain.md): Buy and register domains inside Hercules. Auto-connected to your app. Manage DNS records. No external setup.
- [Connect an existing domain](https://hercules.app/docs/apps/publish/connect-existing-domain.md): Connect a domain you own to your Hercules app. Add DNS records at your registrar. Diagnostics tool for troubleshooting.
- [Publish to a free Hercules subdomain](https://hercules.app/docs/apps/publish/hercules-domain.md): Publish to [myapp].onhercules.app for free. One domain per app. Upgrade to custom domain when ready.
- [Publish your app to Hercules Showcase](https://hercules.app/docs/apps/publish/hercules-showcase.md): Publish Hercules Apps so other users can discover it on 1) the user's public profile and 2) in Hercules' public templates page, and more.
- [Push Notifications](https://hercules.app/docs/apps/push-notifications.md): Send push notifications to users. Setup, permissions, manual sends, event-triggered, and scheduled notifications.
- [Quickstart](https://hercules.app/docs/apps/quickstart.md): Build and publish your first app in 1 minute. Tell Hercules what you want, refine with chat, then publish.
- [Roadmap](https://hercules.app/docs/apps/roadmap.md): Plan large features and migrations with a Roadmap of Initiatives and Milestones.
- [Secrets](https://hercules.app/docs/apps/secrets.md): Store API keys and other sensitive values securely. Scope each secret to production, development, or both. Hercules uses them when building features.
- [Security Audit](https://hercules.app/docs/apps/security.md): Run security audits to find vulnerabilities. Prioritized findings with actionable fixes. Critical and high first.
- [Customize Auth Portal](https://hercules.app/docs/apps/users-auth/customize-auth-portal.md): Configure login methods, auth domain, OTP email, OAuth branding, and more for your Hercules app.
- [Debug Common Auth Issues](https://hercules.app/docs/apps/users-auth/debug-auth.md): Troubleshoot common authentication issues including email OTP, session expiry, captcha, custom domains, and OAuth errors.
- [Hercules Auth](https://hercules.app/docs/apps/users-auth/get-started.md): User authentication with Google, Apple, Microsoft, LinkedIn, or email. Customizable auth portal and role-based access.
- [Upgrade to Hercules Auth 2.0](https://hercules.app/docs/apps/users-auth/upgrade-to-hercules-auth-2.md): Upgrade your app to Hercules Auth 2.0 for control over sign-in methods, your own developer accounts, and a custom auth domain.
- [Users, Roles & Permissions](https://hercules.app/docs/apps/users-auth/users-roles-permissions.md): View and manage your app's users, roles, and permissions. Approve signups, create admin roles, and control access.
- [Version Control](https://hercules.app/docs/apps/version-control.md): Every change creates a version. Revert to previous versions from the Versions tab. Sequential, no branching.
- [Visual Edit](https://hercules.app/docs/apps/visual-edit.md): Edit text, colors, layout, and fonts by clicking elements. Best for small tweaks; use chat for larger changes.
- [Contact Us](https://hercules.app/docs/company/contact.md): Report issues in-app. Sales, security, careers, general inquiries. LinkedIn and Twitter/X.
- [Who We Are](https://hercules.app/docs/company/who-we-are.md): Hercules enables everyone to build custom software by chatting with AI. Founded by Brendan Falk and Grant Gurvis.
- [App Management](https://hercules.app/docs/platform/app-management.md): Manage your apps from the Hercules dashboard. View, duplicate, delete, and transfer apps between organizations.
- [AI Credits](https://hercules.app/docs/platform/billing/ai-credits.md): AI credits power the Hercules AI Agent when building your app. Plans include monthly AI credits. Buy more anytime.
- [Hercules Cloud](https://hercules.app/docs/platform/billing/cloud-credits.md): Full-stack hosting: database, backend, auth, AI, email. Generous free tier. Pay-as-you-go overages via cloud credits.
- [Subscription](https://hercules.app/docs/platform/billing/subscription.md): Hercules subscription plans include hosting, AI credits, and cloud credits.
- [Enterprise](https://hercules.app/docs/platform/enterprise.md): Enterprise security, compliance, and support. SAML SSO, SCIM, SOC2, HIPAA. Contact sales for custom requirements.
- [Export Data](https://hercules.app/docs/platform/export-data.md): Export code, database, and files. Business plans. Download codebase as ZIP. Database with or without media.
- [SSO / SAML](https://hercules.app/docs/platform/sso-saml.md): Login to Hercules via Okta, Azure AD, Google Workspace, or any SAML 2.0 provider. Business plans.
- [Teammates](https://hercules.app/docs/platform/teammates.md): Invite teammates to collaborate. Member, Admin, Owner roles. Multi-agent for parallel work.
- [User Profile and Passwords](https://hercules.app/docs/platform/user-profile.md): Manage email, password, passkeys. Switch organizations. Settings → Profile and Password.
- [Welcome to Hercules](https://hercules.app/docs/welcome.md): Hercules makes it easy to build stunning apps and websites by chatting with AI. Build SaaS, eCommerce, marketing pages, internal tools, mobile apps, and more.

## OpenAPI Specs

- [openapi](https://hercules.app/docs/api-reference/openapi.json)