How do I create a new Flutter app and connect it to Hygraph?
Start by running flutter create <PROJECT_NAME_HERE> to create your app. Clone the Hygraph blog app project for a sample setup. Configure Content API permissions in your Hygraph project, copy the High Performance Content API endpoint, and use it in your Flutter app. Install the graphql_flutter package with flutter pub add graphql_flutter, then configure the GraphQL client in your main.dart file using the endpoint URL. For step-by-step instructions, see the Flutter + Hygraph implementation guide.
How do I fetch and display content from Hygraph in my Flutter app?
Use the graphql_flutter package to run queries against your Hygraph Content API endpoint. For example, you can use a GraphQL query to fetch blog posts and display them using a custom BlogRow widget in a ListView. The implementation guide provides sample code and instructions for displaying posts in your Flutter app. See the official documentation for details.
Can I run my Flutter + Hygraph app on iOS, Android, and the web?
Yes, the sample Flutter app connected to Hygraph can run cross-platform on iOS and Android devices as well as in a browser. The implementation guide provides screenshots and instructions for each platform.
Features & Capabilities
What are the key features of Hygraph for Flutter developers?
Hygraph offers a GraphQL-native Headless CMS, enabling efficient content management and delivery for Flutter apps. Key features include a user-friendly interface, Smart Edge Cache for fast content delivery, high-performance endpoints, content federation, and granular permissions. The graphql_flutter integration allows developers to query only the fields needed, optimizing speed and data usage for mobile applications. Learn more about performance improvements.
How does Hygraph ensure high performance for content delivery?
Hygraph uses Smart Edge Cache and high-performance endpoints to deliver fast and reliable content globally. The platform measures GraphQL API performance and provides practical advice for developers to optimize API usage. These features make Hygraph suitable for high-traffic and global audiences. Read more about endpoint improvements.
Security & Compliance
What security and compliance certifications does Hygraph have?
Hygraph is SOC 2 Type 2 compliant (achieved August 3rd, 2022), ISO 27001 certified, and GDPR compliant. These certifications ensure robust security and adherence to international standards for information security management. For more details, visit the security features page and security and compliance report.
What security features are available in Hygraph?
Hygraph provides granular permissions, SSO integrations, audit logs, encryption at rest and in transit, regular backups, and enterprise-grade compliance features. These measures protect customer data and support regulatory requirements such as GDPR and CCPA. Learn more about Hygraph's security features.
Use Cases & Benefits
Who can benefit from using Hygraph with Flutter?
Hygraph is ideal for developers, product managers, and marketing teams building cross-platform apps with Flutter. It supports businesses in ecommerce, automotive, technology, food and beverage, manufacturing, and more. Organizations seeking to modernize legacy tech stacks, scale content operations, and deliver exceptional digital experiences will benefit from Hygraph's capabilities. See customer stories.
What problems does Hygraph solve for Flutter app development?
Hygraph addresses operational inefficiencies (reducing developer dependency, streamlining workflows), financial challenges (lowering costs, accelerating speed-to-market), and technical issues (simplifying schema evolution, improving integration, optimizing performance). Its GraphQL-native architecture and content federation make it easy to manage and deliver content for modern Flutter apps. Explore CMS KPIs.
Can you share some customer success stories with Hygraph?
Yes. For example, Komax achieved a 3X faster time-to-market managing over 20,000 product variations across 40+ markets via a single CMS. Samsung improved customer engagement by 15% with a scalable member platform. Stobag increased online revenue share from 15% to 70% after transitioning to a digital-first approach. See more customer stories.
Support & Onboarding
What support and resources are available for getting started with Hygraph and Flutter?
Hygraph offers a structured onboarding process, including introduction calls, account provisioning, business and technical kickoffs, and content schema guidance. Customers have access to webinars, live streams, how-to videos, and extensive documentation at Hygraph Documentation. Real-time support is available via 24/7 chat, email, phone, and Intercom chat. Enterprise customers receive a dedicated Customer Success Manager. Join the community Slack channel for peer support.
How long does it take to implement Hygraph for a Flutter project?
Implementation time varies by project scope. For example, Top Villas launched a new project within 2 months from initial contact, and Si Vale met aggressive deadlines during their initial implementation. Hygraph's free API playground and developer account allow teams to start immediately, with structured onboarding and training resources available for a smooth adoption. Read the Top Villas case study.
What kind of ongoing support does Hygraph provide?
Hygraph provides 24/7 support via chat, email, and phone, real-time troubleshooting through Intercom chat, and access to a community Slack channel. Enterprise customers receive a dedicated Customer Success Manager. Extensive documentation and training resources are available for self-paced learning and troubleshooting. Access documentation.
Performance & Metrics
What KPIs and metrics are associated with using Hygraph?
Key metrics include time saved on content updates, system uptime, speed of deployment, consistency in content across regions, user satisfaction scores, reduction in operational costs, ROI on CMS investment, time to market for new products, maintenance costs, scalability metrics, and performance during peak usage. For more details, see the CMS KPIs blog.
Flutter is a cross-platform software development kit (SDK) for mobile app development that uses Dart programming language to create apps for Android and iOS devices.
This guides covers how to connect a Flutter application to Hygraph and query content using a GraphQL client. To create a new Flutter app, run the following command:
After cloning, you will have a simple project that contains a few basic content models that would typically be used in a blog. The Post model contains fields such a title, excerpt, authorName, and coverImage and three sample blog posts in the Content section.
Before you can connect Flutter to Hygraph, you will need to configure Content API access permissions for unauthenticated requests.
To do this, go Project settings > Access > API Access > Content API in your Hygraph project, scroll to find the Content Permissions box that reads Would you like us to initialize some defaults?, and click Yes, initialize defaults:
Content API permissions
Finally, copy the High Performance Content API endpoint from Project settings > Access > API Access > Endpoints. You use it to connect Flutter to Hygraph later on.
Next, you should test if you can fetch the information from the sample blog posts in your project. To do this, navigate to the API Playground in your project and use the following query:
Query
Response
If you execute the query, the response should fetch all the sample blog posts in the demo project you cloned.
After cloning the blog app, navigate to the root of your project cd flutter-hygraph-blog to add the graph_flutter package to your Flutter project. This package provides a set of widgets that make it easy to run queries and mutations with our content from Hygraph in our Flutter project.
To install the GraphQL package, type the following command in the root directory of your Flutter project:
Now, we can use the GraphQLClient() widget and Hygraph content API endpoint URL you copied earlier from your Hygraph project. Add the the endpoint URL to the HttpLink() variable and pass it to the
GraphQLClient() widget in the lib/main.dart file:
That's it! You have successfully connected your Flutter app to Hygraph. You can now run queries and mutations to fetch content from your Hygraph project.
Let's run a query to fetch all the blog posts from your Hygraph project. Add the following code to your lib/main.dart file just below your Hygraph GraphQL client configuration:
// File location: lib/main.dart
constString query ="""
query Posts{
posts{
id
publishedAt
title
excerpt
coverImage {
url
}
author {
id
name
}
}
}
""";
The above query fetches all blog posts from Hygraph and their field content such as id, publishedAt, title, excerpt, coverImage, and author. The great thing about GraphQL is that it allows you to query only the fields you need, which makes your queries faster and more efficient. This makes a difference with any application, but is especially important in mobile applications where data usage and speed are critical.
Your cloned Flutter app contains a directory called widgets that contains a blog_row.dart file that creates a BlogRow widget for displaying the blog posts from Hygraph.
The BlogRow widget is a StatelessWidget that fetches the blog posts from Hygraph and displays them in a ListView widget. In other words, it's a simple widget that displays the blog posts in a list that we can import and use in our main.dart file.
Next, import the BlogRow widget in your lib/main.dart file and add the following code to display the blog posts in your Flutter app:
The above code uses the returned content that we fetched from our blog posts query to display posts in a scrollable list using the ListView.builder widget. The BlogRow widget is used to display each blog post in the list.
We have all these pieces we need to create the Main widget or entry point of our Flutter app. Your lib/main.dart file should have the following code and structure:
Congratulations, you now have a Flutter Blog app that shows posts from Hygraph that is available to run cross-platform on iOS and Android devices as well as in a browser!
Pro Tip
This was a simple and quick example of how to fetch and render content from Hygraph ina Flutter app.