Troubleshooting

Frequently Asked Questions

Common questions about Game Framework.

General

What is Game Framework?

Game Framework is a private Flutter package registry for teams. It lets you host, manage, and distribute private Flutter packages within your organization.

How is it different from pub.dev?

Private packages - Not public
Access control - RBAC with roles
Enterprise features - Audit logs, compliance
Self-hosted - Deploy on your infrastructure

What does it cost?

Free: 5 packages, 5 GB storage
Pro ($49/mo): 50 packages, 100 GB storage
Enterprise: Unlimited, custom pricing

See Billing Plans.

Setup

How do I get started?

Can I use both pub.dev and Game Framework?

Yes! You can use both simultaneously:

dependencies:
  # Private package
  my_private:
    hosted:
      name: my_private
      url: https://registry.yourcompany.com
    version: ^1.0.0
  
  # Public package
  http: ^1.1.0  # From pub.dev

Packages

How many packages can I have?

Depends on your plan:

Free: 5
Pro: 50
Enterprise: Unlimited

Can I migrate from pub.dev?

Yes! See Migration Guide.

Can I publish to both pub.dev and Game Framework?

Yes, see Dual Publishing.

Security

Is my code secure?

Yes:

TLS 1.3 encryption in transit
AES-256 encryption at rest
RBAC access control
Audit logging
SOC 2, GDPR, HIPAA compliant

Who can see my packages?

Only workspace members with appropriate permissions.

Can I use 2FA?

Yes, 2FA is supported and can be required for all workspace members.

Technical

What Flutter versions are supported?

Flutter 3.0+ and Dart 3.0+.

Can I self-host?

Yes! Deploy with Docker, Kubernetes, or cloud providers. See Installation.

Does it work with CI/CD?

Yes! We have guides for:

GitHub Actions
GitLab CI
Jenkins
CircleCI
Others

See CI/CD Integration.

What about monorepos?

Fully supported! Publish multiple packages from one repository.

Billing

What happens if I hit package limit?

You'll get a 402 Payment Required error. Upgrade your plan or delete unused packages.

Can I upgrade anytime?

Yes, upgrade or downgrade anytime. Prorated billing.

Is there a free trial?

The Free plan is always free (5 packages). No credit card required.

Support

How do I get help?

What's the SLA?

Free: Best effort
Pro: 99.5% uptime
Enterprise: 99.9% uptime + dedicated support

Can I get a demo?

Yes! Email sales@gameframework.dev for a personalized demo.

Compliance

Yes, full GDPR compliance including data export and deletion.

Is it HIPAA compliant?

Yes, HIPAA compliance available on Enterprise plan with BAA.

Where is data stored?

Choose your region:

US (us-east-1, us-west-2)
EU (eu-west-1, eu-central-1)
Asia (ap-southeast-1)

Migration

How long does migration take?

Depends on number of packages. Typically:

Small (1-10 packages): 1 hour
Medium (10-50 packages): Half day
Large (50+ packages): 1-2 days

Will my apps break during migration?

No, if you follow the migration guide. Update dependencies gradually.

Can I migrate back to pub.dev?

Yes, packages can be published to both registries.

Still Have Questions?

Can't find your answer? Email support@gameframework.dev or join our Community Slack.

Debugging

Debug Game Framework issues

API Reference

Complete Game Framework API reference