Skip to content

Implement Flutter blog and integrate old articles#13558

Open
schultek wants to merge 60 commits into
mainfrom
feat/blog
Open

Implement Flutter blog and integrate old articles#13558
schultek wants to merge 60 commits into
mainfrom
feat/blog

Conversation

@schultek

@schultek schultek commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Implements the Flutter Blog as part of the marketing site using Jaspr.

  • Blog content is located at sites/www/content/blog.
  • Authors are defined in sites/www/content/blog/authors.yaml.

Preview: https://flutter-dev-230821--www-pr13558-feat-blog-aajb5l2g.web.app/blog

Contributes to #13507

@schultek schultek self-assigned this Jul 7, 2026
@flutter-website-bot

flutter-website-bot commented Jul 7, 2026

Copy link
Copy Markdown
Collaborator

Staged preview of the updated docs.flutter.dev site (updated for commit f0126f3):

https://flutter-docs-prod--docs-pr13558-feat-blog-drugp8f0.web.app

@flutter-website-bot

flutter-website-bot commented Jul 7, 2026

Copy link
Copy Markdown
Collaborator

Staged preview of the updated flutter.dev site (updated for commit f0126f3):

https://flutter-dev-230821--www-pr13558-feat-blog-aajb5l2g.web.app

@kjxbyz

kjxbyz commented Jul 7, 2026

Copy link
Copy Markdown

To be honest, I don't like blog systems without comment features.

@parlough

parlough commented Jul 8, 2026

Copy link
Copy Markdown
Member

To be honest, I don't like blog systems without comment features.

Thanks for the feedback! Once our blogs are both migrated and given some time in production, depending on community feedback, we might consider investigating support for comments and/or reactions. It requires additional planning, work, and process due to involving user data, so we won't be including support as part of this initial implementation.

In the mean time, blog posts can be (and often are) discussed on some of the great Flutter communities or on social media.

@parlough

parlough commented Jul 15, 2026

Copy link
Copy Markdown
Member

Thanks for the hard work on this @schultek!

Just commenting a few issues, notes, and ideas from our discussion so they don't get lost:

  • Flip visual hierarchy of multiple authors (first highest)
  • Slightly increase spacing of multiple author icons, so more of each one shows.
  • Fix <YoutubeEmbed>, perhaps by setting up lite-youtube script like the docs site.
  • Combine author yaml files into a single authors.yaml at the root of the blog/ directory.
  • Remove unused fields from author yaml entries.
  • Drop shadow of navbar is missing on blog pages. Seems we should keep it (or something similar) for clarity.
  • Switching categories on the blog home page changes the query parameters and the page's contents. Using the browser back buttons changes the query parameters but the page contents don't update.
  • Adjust available categories, make them required, and review each post to ensure it has an accurate one. (b4f55b6)

Questions:

  • Should we hide the site banner like we did on the Dart blog?

@schultek
schultek marked this pull request as ready for review July 20, 2026 07:28
@schultek
schultek requested review from a team and abdallahshaban557 as code owners July 20, 2026 07:28

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request implements a new blog system, adding several UI components, data models, and Atom feed generation. It also updates the site layout to include improved social media meta tags and adds necessary dependencies for internationalization and XML processing. The code review identified several critical runtime issues, specifically regarding YAML map parsing, frontmatter date handling, and page filtering logic that could cause build crashes. Additionally, a null-safety improvement for the clipboard API was suggested. All review comments are actionable and address potential stability and safety issues; therefore, no comments were removed.

Comment thread packages/site_shared/lib/src/blog/models.dart
Comment thread packages/site_shared/lib/src/blog/models.dart
Comment thread packages/site_shared/lib/src/blog/models.dart Outdated
Comment thread packages/site_shared/lib/src/blog/models.dart
Comment thread packages/site_shared/lib/components/blog/blog_index.dart
Comment thread packages/site_shared/lib/src/blog/atom_feed.dart
Comment thread packages/site_shared/lib/src/blog/atom_feed.dart
Comment thread packages/site_shared/lib/components/blog/client/share_button.dart
schultek and others added 3 commits July 20, 2026 10:15
# Conflicts:
#	packages/site_shared/lib/src/layouts/dash_layout.dart
#	packages/site_shared/pubspec.yaml
#	sites/www/lib/src/style_hash.dart
@abdallahshaban557

Copy link
Copy Markdown
Contributor

@parlough - can you check the build failure? I am reviewing this now as well!

@schultek

Copy link
Copy Markdown
Contributor Author

I'm looking into this right now. The build fails as part of this workflow, but succeeds for the deployment job which is a bit strange.

@schultek

Copy link
Copy Markdown
Contributor Author

All green now.

@abdallahshaban557 @parlough Once you approve I would merge this. 🚀

@abdallahshaban557

Copy link
Copy Markdown
Contributor

@parlough - can we have the date and reading time wrap to a new line always, similar to what is shown in the left hand image I am attaching for consistency?
image

@abdallahshaban557

Copy link
Copy Markdown
Contributor

@parlough - another build failure it seems

@parlough parlough left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great to me. Thanks for the hard work on this @schultek! Do wait for @abdallahshaban557 to approve before landing.

If anything else comes up, we can follow with those improvements before we update the blog.flutter.dev redirects.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants