From 1aa7d356e8eea08ceb04a0e5bc3b97536ae6b082 Mon Sep 17 00:00:00 2001 From: Kingkor Roy Tirtho Date: Thu, 19 Oct 2023 10:35:42 +0600 Subject: [PATCH] docs: prefers-color-scheme based color scheme --- docs/docs/getting-started/overview.md | 13 +--- docs/docusaurus.config.js | 91 ++++++++++++++------------- 2 files changed, 50 insertions(+), 54 deletions(-) diff --git a/docs/docs/getting-started/overview.md b/docs/docs/getting-started/overview.md index 2eca1c3..7392d8c 100644 --- a/docs/docs/getting-started/overview.md +++ b/docs/docs/getting-started/overview.md @@ -4,7 +4,7 @@ title: Overview id: overview --- -Asynchronous data caching, refetching & invalidation library for Flutter. FL-Query lets you manage & distribute your async data without touching any global state +Asynchronous data caching, refetching & invalidation library for Flutter. Fl-Query lets you manage & distribute your async data without touching any global state Fl-Query makes asynchronous server state management a breeze in flutter @@ -33,10 +33,6 @@ For elite flutter_hooks user (Welcome to the flutter cool community btw😎) $ flutter pub add flutter_hooks fl_query_hooks ``` -## Docs - -You can find the documentation of fl-query at https://fl-query.krtirtho.dev/ - ## Basic Usage Initialize the cache databases in your `main` method @@ -158,15 +154,12 @@ class MyApp extends HookWidget{ } ``` -*To master the fl-query follow the official blog at https://fl-query.krtirtho.dev/blog* - ## Why?

The hell, why?

-The main purpose of Fl-Query is providing the easiest way to manage the messy server-state part requiring the least amount of code with code reusability & performance -This let's you focus more on those cool UI animations & transitions✨. Leave the boring stuff to fl-query +The main purpose of Fl-Query is providing the easiest way to manage the messy server-state part requiring the least amount of code with code reusability & performance. This let's you focus more on those cool UI animations & transitions✨. Leave the boring stuff to Fl-Query **Q. Isn't `FutureBuilder` good?** @@ -174,4 +167,4 @@ This let's you focus more on those cool UI animations & transitions✨. Leave th **Q. So `FutureProvider` from riverpod or provider not enough?** -Probably yes. Although riverpod@v2 has added a lot of caching related features but still optimistic updates, periodic refetching & disk persistence are missing. Let's not forget about infinite pagination, it's a nightmare😅. In case of provider, same story. It's a great package but it's not ideal for server-state management \ No newline at end of file +Probably yes. Although riverpod@v2 has added a lot of caching related features but still optimistic updates, periodic refetching & disk persistence are missing. Let's not forget about infinite pagination, it's a nightmare😅. In case of provider, same story. It's a great package but it's not the easiest one for server-state management \ No newline at end of file diff --git a/docs/docusaurus.config.js b/docs/docusaurus.config.js index fed835c..5adb3a8 100644 --- a/docs/docusaurus.config.js +++ b/docs/docusaurus.config.js @@ -1,22 +1,22 @@ // @ts-check // Note: type annotations allow type checking and IDEs autocompletion - -const { themes } = require('prism-react-renderer'); + +const { themes } = require("prism-react-renderer"); /** @type {import('@docusaurus/types').Config} */ const config = { - title: 'Fl-Query', - tagline: 'Async data manager for Flutter', - url: 'https://flquery.com', - baseUrl: '/', - onBrokenLinks: 'throw', - onBrokenMarkdownLinks: 'warn', - favicon: 'img/favicon.ico', + title: "Fl-Query", + tagline: "Async data manager for Flutter", + url: "https://flquery.com", + baseUrl: "/", + onBrokenLinks: "throw", + onBrokenMarkdownLinks: "warn", + favicon: "img/favicon.ico", // GitHub pages deployment config. // If you aren't using GitHub pages, you don't need these. - organizationName: 'Kingkor Roy Tirtho', // Usually your GitHub org/user name. - projectName: 'Fl-Query', // Usually your repo name. + organizationName: "Kingkor Roy Tirtho", // Usually your GitHub org/user name. + projectName: "Fl-Query", // Usually your repo name. plugins: [ async function TailwindCSSPlugin(context, options) { @@ -36,31 +36,31 @@ const config = { // metadata like html lang. For example, if your site is Chinese, you may want // to replace "en" with "zh-Hans". i18n: { - defaultLocale: 'en', - locales: ['en'], + defaultLocale: "en", + locales: ["en"], }, presets: [ [ - 'classic', + "classic", /** @type {import('@docusaurus/preset-classic').Options} */ ({ docs: { - sidebarPath: require.resolve('./sidebars.js'), + sidebarPath: require.resolve("./sidebars.js"), // Please change this to your repo. // Remove this to remove the "edit this page" links. editUrl: - 'https://github.com/KRTirtho/fl-query/tree/main/packages/docs/docs/', + "https://github.com/KRTirtho/fl-query/tree/main/packages/docs/docs/", }, blog: { showReadingTime: true, // Please change this to your repo. // Remove this to remove the "edit this page" links. editUrl: - 'https://github.com/KRTirtho/fl-query/tree/main/packages/docs/blog/', + "https://github.com/KRTirtho/fl-query/tree/main/packages/docs/blog/", }, theme: { - customCss: require.resolve('./src/css/custom.css'), + customCss: require.resolve("./src/css/custom.css"), }, }), ], @@ -69,62 +69,65 @@ const config = { themeConfig: /** @type {import('@docusaurus/preset-classic').ThemeConfig} */ ({ + colorMode: { + respectPrefersColorScheme: true, + }, navbar: { - title: 'Fl-Query', + title: "Fl-Query", logo: { - alt: 'Fl-Query Logo', - src: 'img/logo.svg', + alt: "Fl-Query Logo", + src: "img/logo.svg", }, items: [ { - type: 'doc', - docId: 'getting-started/overview', - position: 'left', - label: 'Documentation', + type: "doc", + docId: "getting-started/overview", + position: "left", + label: "Documentation", }, - {to: '/blog', label: 'Blog', position: 'left'}, + { to: "/blog", label: "Blog", position: "left" }, { - href: 'https://github.com/KRTirtho/fl-query', - label: 'GitHub', - position: 'right', + href: "https://github.com/KRTirtho/fl-query", + label: "GitHub", + position: "right", }, ], }, footer: { - style: 'dark', + style: "dark", links: [ { - title: 'Docs', + title: "Docs", items: [ { - label: 'Documentation', - to: '/docs/getting-started/overview', + label: "Documentation", + to: "/docs/getting-started/overview", }, ], }, { - title: 'Community', + title: "Community", items: [ { - label: 'Stack Overflow', - href: 'https://stackoverflow.com/questions/tagged/fl-query', + label: "Stack Overflow", + href: "https://stackoverflow.com/questions/tagged/fl-query", }, { - label: 'Twitter', - href: 'https://twitter.com/KrTirtho', + label: "Twitter", + href: "https://twitter.com/KrTirtho", }, ], }, { - title: 'More', + title: "More", items: [ { - label: 'Blog', - to: '/blog', + label: "Blog", + to: "/blog", }, { - label: 'GitHub', - href: 'https://github.com/KRTirtho/fl-query', + label: "GitHub", + href: "https://github.com/KRTirtho/fl-query", }, ], }, @@ -134,7 +137,7 @@ const config = { prism: { theme: themes.oneLight, darkTheme: themes.oneDark, - additionalLanguages: ["dart"] + additionalLanguages: ["dart"], }, }), };