Feat/apply readmes to pages + privacy policy + code of conduct + UI and UX improvements for Starters and Builders (#4)

* fix: spread operator added for website routes

* chore: add launch configuration for Dart in VSCode

* fix: update hero section title structure in home page

* refactor: enhance Builders and Starters pages with structured sections and improved routing

* Change path variables to constants for better clarity.
* Refactor route methods to use generator functions for improved performance.
* Introduce new sections (_HeroSection, _AboutSection, _MissionSection, _WhatWeDoSection, _JoinSection, _ContributorsSection) in BuildersPage.
* Add structured sections (_HeroSection, _CoreConceptsSection, _OfficialDocsSection, _DeepenUnderstandingSection, _ContributeSection, _ComingNextSection) in StartersPage.
* Update styles for category sections and improve focus visibility in CSS.

* feat: introduce new content components for enhanced page structure

* Add ContentSection, ContentCard, and EmojiCallout components for better modularity.
* Refactor BuildersPage and StartersPage to utilize new components for improved readability and maintainability.
* Update sections to use structured components, enhancing the overall layout and user experience.

* feat: add new styles for content sections and cards

* Introduce styles for content sections, cards, resource links, and emoji callouts to enhance layout and user experience.
* Implement hover effects and improved spacing for better visual appeal.
* Add styles for hero content and coming next sections to maintain consistency across the site.

* feat: enhance ResourceLink and ResourceCategory components with new variants and styles

* Introduce CardVariant and CategoryAccent enums to manage different styles for resource links and categories.
* Update ResourceLink to support multiple visual variants, improving flexibility in design.
* Refactor ResourceCategory to allow for grid layout and horizontal scrolling options.
* Enhance CSS styles for resource links and categories, including hover effects and responsive adjustments.
* Integrate new components into BuildersPage and StartersPage for improved content organization and visual appeal.

* feat: enhance content components with new properties and styles

* Add elevated and animateCta properties to ContentCard for improved visual effects.
* Introduce blurred property to EmojiCallout for enhanced styling options.
* Update ContentSection to conditionally apply elevated styles.
* Enhance ResourceCategory to support masonry grid layout and dynamic scroll buttons.
* Implement JavaScript for scrollable containers to improve user interaction.
* Refactor CSS for better responsiveness and visual consistency across components.

* feat: add Builder's Toolkit section and enhance feature card presentation

* Introduce a new Builder's Toolkit section in BuildersPage to provide resources and tools for Flutter developers.
* Enhance feature cards with optional emoji support for improved visual engagement.
* Update CSS to style feature card emojis for better alignment and presentation.
* Refactor existing sections to maintain consistency and improve overall layout.

* feat: update resource links and enhance call-to-action button

* Change the link for the Flutter GenAI resource to the correct package URL.
* Replace the text in the call-to-action button with a link to contribute on GitHub, improving user engagement.
* Update the coming next text to include a more inviting message for users to stay tuned for additional resources.

* feat: add TODO for future link in HeroSection

* Add a TODO comment to the HeroSection for linking to the "What is Agentic Flutter?" page once it is created, enhancing future content planning.

* feat: enhance accessibility and improve emoji handling in components

* Update ContentSection and EmojiCallout to include aria attributes for better screen reader support.
* Add a helper method to provide descriptions for common emojis, enhancing accessibility for visually impaired users.
* Improve styling for resource links and scroll buttons in ResourceCategory for better contrast and usability.
* Add TODO comments in BuildersPage for future documentation links, aiding in content planning.

* refactor: comment out unused link in HeroSection for future content planning

* Comment out the link to the "What is Agentic Flutter?" page in the HeroSection, maintaining the TODO for future implementation once the page is created. This enhances clarity in the code and aids in content planning.

* feat: add new external links and enhance footer component

* Introduce a new YouTube link for Agentic QA in the ExternalLink enum.
* Update the Footer component to utilize the new YouTube link and survey link, improving resource accessibility.
* Modify the link rendering logic in FooterColumn to handle external links with appropriate attributes for better accessibility and security.
* Update the HomePage to include the new YouTube link for "What is Agentic Flutter?" and adjust feature cards to reference the correct URLs, enhancing user engagement.

* fix: update link attributes in HeroSection and enhance button hover style

* Add comments to clarify the purpose of the YouTube link in the HeroSection, improving code readability.
* Update CSS to include a pointer cursor on hover for the secondary button, enhancing user interaction and visual feedback.
* Comment out unused CSS for a previously animated gradient, streamlining the styles for better performance.

* feat: update resource links in StartersPage for improved content accessibility

* Remove outdated dart_openai link and replace it with mcp_dart, enhancing the variety of SDKs available for users.
* Reintroduce the dart_openai link with updated description, ensuring users have access to relevant resources for OpenAI APIs.
* Streamline resource links to provide a more comprehensive set of tools for developers.

* feat: update StartersPage with new external link and improve button accessibility

* Add external link for the Contributors Survey, enhancing user engagement and resource accessibility.
* Remove masonry grid usage in ResourceCategory for a cleaner layout.
* Update button text for clarity, improving call-to-action effectiveness.
* Adjust CSS for button styles to ensure consistent height and box-sizing, enhancing visual presentation.

* feat: add new YouTube link and enhance Coming Next section in StartersPage

* Introduce a new YouTube link for the Flutter Community channel in the ExternalLink enum, improving resource accessibility.
* Update the Coming Next section title and emoji for better engagement.
* Revise button texts to clarify actions and enhance user interaction.
* Adjust CSS for buttons to ensure consistent layout and spacing, improving visual presentation.

* feat: enhance footer component with 'Coming soon' links and tooltip styling

* Update footer links for 'Privacy Policy' and 'Code of Conduct' to indicate they are coming soon, improving user experience.
* Implement tooltip functionality for 'Coming soon' links to provide additional context, enhancing accessibility.
* Add CSS styles for 'Coming soon' links, ensuring they visually align with inactive link standards and include hover effects for tooltips.

* feat: add new external links and enhance resource descriptions in StartersPage

* Introduce a new YouTube link for Jhin Lee's Humpday Q&A and a link to the Gemini API function calling documentation in the ExternalLink enum, improving resource accessibility.
* Update the description for the Gemini API link to provide clearer context on its purpose and usage.
* Revise the description for the Agentic Apps with Flutter resource to offer a more detailed overview of the content, enhancing user engagement.

* feat: add Privacy Policy and Code of Conduct pages with routing

* Introduce new PrivacyPolicyPage and CodeOfConductPage components, enhancing the website's legal information accessibility.
* Update the website and footer routing to include links to the new pages, improving user navigation and compliance visibility.
* Ensure proper integration of new routes within the existing application structure for seamless user experience.

* feat: enhance BuildersPage with new survey section and resource links

* Introduce a new _SurveySection component to encourage community feedback and participation, improving user engagement.
* Update BuildersPage to include the new survey section, enhancing the visibility of community contributions.
* Revise resource links and descriptions for clarity and accessibility, ensuring users have easy access to relevant resources.
* Add CSS styles for clickable resource cards, improving the overall user experience and interaction with resource links.

* feat: update survey section in BuildersPage for improved user engagement

* Refactor _SurveySection component to enhance the survey callout design and improve accessibility.
* Update CSS styles for the survey callout, including new container classes and improved layout for better visual presentation.
* Adjust survey title and description for clarity, encouraging community participation and feedback.
* Ensure consistent styling and spacing for buttons within the survey section, enhancing user interaction.

* feat: enhance navigation and footer functionality for improved user experience

* Integrate JavaScript for automatic scroll reset on navigation, ensuring users start at the top of the page after navigating to internal links.
* Update Footer component to include scroll reset functionality on link clicks, enhancing navigation consistency.
* Refactor TakeSurvey component to allow customizable button text and additional CSS classes, improving flexibility and user engagement.
* Revise resource links in BuildersPage to utilize new SurveyCallout component, streamlining the layout and enhancing visual appeal.
* Update CSS styles for clickable cards and section spacers, ensuring a cohesive design across the application.

* feat: enhance Navbar and ResourceLink components for improved usability and design

* Implement mobile menu toggle functionality in Navbar, allowing users to easily access navigation links on smaller screens.
* Refactor ResourceLink component to streamline the structure and improve accessibility by using URL directly instead of link attributes.
* Update CSS styles for Navbar and resource cards, enhancing visual appeal and responsiveness across devices.
* Ensure consistent layout and spacing for navigation and resource links, improving overall user experience.

* feat: update ResourceCategory and ResourceLink components for improved structure and functionality

* Refactor ResourceCategory to utilize helper methods for rendering scrollable containers, resource lists, and grids, enhancing code readability and maintainability.
* Introduce accent class handling in ResourceCategory for better visual differentiation based on category type.
* Enhance ResourceLink by implementing a variant class system, allowing for more flexible styling options.
* Update website.dart to include new JavaScript files for improved functionality, ensuring better user experience with dynamic content.

* chore: remove outdated README files from builders and starters sections

* Delete README.md files from the builders and starters directories, as they contained outdated information and are no longer relevant to the project.
* This cleanup helps streamline documentation and maintain focus on current resources and guidelines.

* chore: update project configuration and dependencies

* Add .fvmrc file to specify Flutter version 3.29.3 for consistent development environment.
* Update Dart SDK constraints in pubspec.yaml to allow versions from 3.3.0 to less than 4.0.0.
* Modify pubspec.lock to reflect Dart SDK version change.
* Enhance VSCode launch configurations for improved development experience with new options for running with webdev.
* Introduce settings.json and tasks.json for better integration with VSCode, including a task for webdev serve with auto-refresh capability.

* Fix responsiveness

* Remove broken link

* Remove weird scrollbar on mobile view

---------

Co-authored-by: Jhin Lee <[email protected]>

Author: esrakadah

.fvmrc

@@ -0,0 +1,3 @@
+{
+  "flutter": "3.29.3"
+}

.vscode/launch.json

@@ -0,0 +1,27 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Run with Dart",
+            "request": "launch",
+            "type": "dart",
+            "program": "web/main.dart"
+        },
+        {
+            "name": "Run with webdev (auto-refresh)",
+            "request": "launch",
+            "type": "dart",
+            "program": "web/main.dart",
+            "args": [
+                "--web-renderer",
+                "html",
+                "--web-port",
+                "8080"
+            ],
+            "preLaunchTask": "webdev-serve"
+        }
+    ]
+}

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+  "dart.flutterSdkPath": ".fvm/versions/3.29.3"
+}

.vscode/tasks.json

@@ -0,0 +1,25 @@
+{
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "label": "webdev-serve",
+            "type": "shell",
+            "command": "webdev serve --auto refresh",
+            "isBackground": true,
+            "problemMatcher": {
+                "owner": "dart",
+                "pattern": {
+                    "regexp": ".",
+                    "file": 1,
+                    "location": 2,
+                    "message": 3
+                },
+                "background": {
+                    "activeOnStart": true,
+                    "beginsPattern": "^\\[INFO\\] Serving",
+                    "endsPattern": "^\\[INFO\\] Succeeded"
+                }
+            }
+        }
+    ]
+} 

docs/builders/README.md

@@ -1,6 +1,11 @@
 enum ExternalLink {
   youTubePlaylist('https://www.youtube.com/playlist?list=PL4dBIh1xps-HIYvaEIbLWHZqt_WGBfpx3'),
   youTubeVibeCoding('https://www.youtube.com/playlist?list=PL4dBIh1xps-GLrzqijiTRuzdtxP3bfqsQ'),
+  youTubeAgenticQA('https://www.youtube.com/live/XRuKywXD7zM?si=KHjiSKayFwuFz7GH'),
+  youTubeFlutterCommunity('https://www.youtube.com/@FlutterCommunity'),
+  youTubeJhinLeeMCPHumpdayQA('https://www.youtube.com/live/1U-zd6MYrOA?si=HdWVE-H8zDNOL0Sx&t=1794'),
+  geminiFunctionCallingDocs(
+      'https://ai.google.dev/gemini-api/docs/function-calling?example=meeting'),
   forumCategory('https://forum.itsallwidgets.com/c/ai/46'),
   forumChat('https://forum.itsallwidgets.com/chat/c/fc-ai-circle/40'),
   surveyCommunity('https://forms.gle/JrC11pxRz6TLyB2L9'),

docs/starters/README.md

@@ -1,6 +1,8 @@
 import 'package:fc_ai_circle/src/pages/builders_page.dart';
 import 'package:fc_ai_circle/src/pages/home_page.dart';
 import 'package:fc_ai_circle/src/pages/starters_page.dart';
+import 'package:fc_ai_circle/src/pages/privacy_policy_page.dart';
+import 'package:fc_ai_circle/src/pages/code_of_conduct_page.dart';
 import 'package:jaspr/browser.dart';
 import 'package:jaspr_router/jaspr_router.dart';
 
@@ -18,14 +20,18 @@ class _SiteState extends State<Website> {
       children: [
         link(href: '/css/fontawesome.css', rel: 'stylesheet'),
         link(href: '/css/brands.css', rel: 'stylesheet'),
-        // Style(styles: resetStyles)
+        link(href: '/css/clickable-cards.css', rel: 'stylesheet'),
+        script(src: '/js/scroll.js', attributes: {'defer': 'true'}, []),
+        script(src: '/js/clickable-cards.js', attributes: {'defer': 'true'}, []),
       ],
     );
     yield Router(
       routes: [
         ...HomePage.route(),
-        StartersPage.route(),
-        BuildersPage.route(),
+        ...StartersPage.route(),
+        ...BuildersPage.route(),
+        ...PrivacyPolicyPage.route(),
+        ...CodeOfConductPage.route(),
       ],
     );
   }