diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
deleted file mode 100644
index 4b930db..0000000
--- a/.github/workflows/deploy.yml
+++ /dev/null
@@ -1,39 +0,0 @@
-name: deploy Github pages
-
-on:
- # Trigger the workflow every time you push to the `main` branch
- # Using a different branch name? Replace `main` with your branch’s name
- push:
- branches: [ master ]
- # Allows you to run this workflow manually from the Actions tab on GitHub.
- workflow_dispatch:
-
-# Allow this job to clone the repo and create a page deployment
-permissions:
- contents: read
- pages: write
- id-token: write
-
-jobs:
- build:
- runs-on: ubuntu-latest
- steps:
- - name: Checkout your repository using git
- uses: actions/checkout@v3
- - name: Install, build, and upload your site
- uses: withastro/action@v1
- with:
- path: ./docs # The root location of your Astro project inside the repository. (optional)
- # node-version: 18 # The specific version of Node that should be used to build your site. Defaults to 18. (optional)
- package-manager: pnpm@latest # The Node package manager that should be used to install dependencies and build your site. Automatically detected based on your lockfile. (optional)
-
- deploy:
- needs: build
- runs-on: ubuntu-latest
- environment:
- name: github-pages
- url: ${{ steps.deployment.outputs.page_url }}
- steps:
- - name: Deploy to GitHub Pages
- id: deployment
- uses: actions/deploy-pages@v1
\ No newline at end of file
diff --git a/README.md b/README.md
index 3a70b02..d2d3c4c 100644
--- a/README.md
+++ b/README.md
@@ -1,49 +1,49 @@
-
-
-
-
-
-## What is fastGQL?
-
-[*fastGQL*](https://github.com/roneli/fastgql) is a Go library that
-extends [gqlgen](https://github.com/99designs/gqlgen) to create a blazing-fast GraphQL server that gives you instant,
-realtime GraphQL APIs over Postgres.
-
-- **fastgql is based on a Schema first approach** — You get to Define your API using the
- GraphQL [Schema Definition Language](http://graphql.org/learn/schema/).
-- **fastgql prioritizes extendability** — You can modify resolvers, add your own custom operators and even create your
- own database query builder.
-- **fastgql enables codegen** — We generate even more of the boring CRUD bits, so you can focus on building your app
- even faster!
-
-## Getting Started
-
-- To install fastgql run the command `go get github.com/roneli/fastgql` in your project directory.2 svg
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/src/assets/logo_light.svg b/docs/src/assets/logo_light.svg
index 13dd0d4..d6f7884 100644
--- a/docs/src/assets/logo_light.svg
+++ b/docs/src/assets/logo_light.svg
@@ -1 +1,74 @@
-1 svg
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/src/assets/panda.svg b/docs/src/assets/panda.svg
new file mode 100644
index 0000000..ae4e3e3
--- /dev/null
+++ b/docs/src/assets/panda.svg
@@ -0,0 +1,2863 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/src/components/ScriptComponent.astro b/docs/src/components/ScriptComponent.astro
new file mode 100644
index 0000000..f3aba32
--- /dev/null
+++ b/docs/src/components/ScriptComponent.astro
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/docs/src/components/ThemeSelect.astro b/docs/src/components/ThemeSelect.astro
new file mode 100644
index 0000000..c3e41b5
--- /dev/null
+++ b/docs/src/components/ThemeSelect.astro
@@ -0,0 +1,65 @@
+---
+import { Icon } from "astro-icon/components";
+---
+
+
+
+ Use light theme
+
+
+ Use dark theme
+
+
+
+{/* Inlined to avoid FOUC. Uses global scope from `ThemeProvider.astro` */}
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/src/content/docs/index.mdx b/docs/src/content/docs/index.mdx
index 2627932..8966bcb 100644
--- a/docs/src/content/docs/index.mdx
+++ b/docs/src/content/docs/index.mdx
@@ -1,36 +1,40 @@
----
-title: Welcome to FastGQL.io
-description: Get started building your docs site with Starlight.
-template: splash
-hero:
- tagline: Congrats on setting up a new Starlight project!
- image:
- file: ../../assets/logo_dark.svg
- actions:
- - text: Get Started
- link: /fastgql/start/setup/
- icon: right-arrow
- variant: primary
- - text: Read the Starlight docs
- link: https://starlight.astro.build
- icon: external
----
-
-import { Card, CardGrid } from '@astrojs/starlight/components';
-
-## Next steps
-
-
-
- Edit `src/content/docs/index.mdx` to see this page change.
-
-
- Add Markdown or MDX files to `src/content/docs` to create new pages.
-
-
- Edit your `sidebar` and other config in `astro.config.mjs`.
-
-
- Learn more in [the Starlight Docs](https://starlight.astro.build/).
-
-
+---
+title: fastGQL
+description: Get started building your docs site with Starlight.
+template: splash
+hero:
+ title:
+ tagline: Schema-First GraphQL API Library powered by gqlgen.
+
+ generate Queries.
+
+ actions:
+ - text: Get Started
+ link: /start/setup/
+ icon: right-arrow
+ variant: primary
+ - text: View on GitHub
+ link: https://github.com/roneli/fastgql
+ icon: external
+ image:
+ file: /src/assets/panda.svg
+---
+
+import "/src/styles/overrides.css";
+import { Card, CardGrid } from '@astrojs/starlight/components';
+import ScriptWorkaround from "/src/components/ScriptComponent.astro";
+
+
+
+ Automatically generate resolvers with Filters,Mutations,Aggregates, pagination etc'
+
+
+ FastGQL is a library, not a framework, easily add your own custom code to generated resolvers.
+
+
+ Define your schema first we will generate the boring CRUD resolvers for you.
+
+
+ Learn more in [FastGQL Docs](/start/intro).
+
+
diff --git a/docs/src/content/docs/queries/filtering.mdx b/docs/src/content/docs/queries/filtering.mdx
index 9fbb6fb..574cd8b 100644
--- a/docs/src/content/docs/queries/filtering.mdx
+++ b/docs/src/content/docs/queries/filtering.mdx
@@ -1,137 +1,127 @@
----
-title: Filtering
-description: Filter queries with FastGQL
----
-
-import { Tabs, TabItem } from '@astrojs/starlight/components';
-
-# Filtering
-
-FastGQL extends the GraphQL schema adding `filter` input for objects and adding `filter` arguments to the queries and mutations. We can use the `filter` argument in our queries to filter results based on the field's values. FastGQL allows to add multiple filters with `AND`, `OR`, `NOT` and even nested object filters.
-
-## Simple Operators
-
-fetch posts with where `id == 3`
-
-```graphql
-query {
- posts(limit: 3, filter: { id: { eq: 3 } }) {
- id
- }
-}
-```
-
-## Logical filters
-
-#### AND filter
-
-By default, a logical `AND` operation is preformed on all the conditions mentioned in the filter clause. If we want to use the same field key, than we need to use the `AND` operator in the GraphQL query.
-
-
-
- ```graphql
- query {
- # expected filter: name = "article 1" AND id = 1
- posts(filter: {name: {eq: "article 1"}, id: {eq: 1}}) {
- id
- name
- }
- }
- ```
-
-
-
-
-
- ```graphql
- query {
- posts(
- # expected filter: name = "article 1" AND name like "%article%" AND id = 1
- filter: {
- AND: [
- {name: {eq: "article 1"}}
- {name: {like: "%article%"}}
- {id: {eq: 1}}
- ]
- }
- ) {
- id
- name
- }
- }
- ```
-
-
-
-#### OR filter
-
-To perform a logical `OR` operation, we have to use the `OR` operator in the GraphQL query.
-
-If we would like to fetch information of all post's name that start with the prefix `a` or `b` the following query will return the desired result:
-
-```graphql
-query {
- posts(
- filter: { OR: [{ name: { prefix: "a" } }, { name: { suffix: "b" } }] }
- ) {
- id
- name
- }
-}
-```
-
-#### NOT filter
-
-To perform a logical `NOT`operation, we have to use the `NOT`operator in the GraphQL query.
-
-if we would like to fetch information of all post's name that **don't** start with "a" or ends with "b". the following query will return the desired result:
-
-```graphql
-query {
- posts(
- filter: {
- NOT: { OR: [{ name: { prefix: "a" } }, { name: { suffix: "b" } }] }
- }
- ) {
- id
- name
- }
-}
-```
-
-#### Nested filters
-
-We can also perform complex nested logical operation, such as `OR` inside an `AND` operator. The following query will result the following filter:
-
-```sql
-(name like 'b%' OR name like 'a%') AND name like '%c%'
-```
-
-```graphql
-query {
- posts(
- filter: {
- AND: [
- { OR: [{ name: { prefix: "a" } }, { name: { suffix: "b" } }] }
- { name: { like: "%c%" } }
- ]
- }
- ) {
- id
- name
- }
-}
-```
-
-## Object Filters
-
-Most objects in our schema usually have fields that aren't `scalars`, and we would like to filter by thier fields. In our example each post has one or more categories we would want to filter posts by some category name. The following GraphQL query will filter for us those posts that have a category name called "Security"
-
-```graphql
-query ObjectFilterExample {
- posts(filter: {categories: {name: {eq: "Security"}}}) {
- id
- name
- }
-}
-```
+---
+title: Filtering
+description: Filter queries with FastGQL
+---
+
+
+import {TabItem, Tabs} from '@astrojs/starlight/components';
+
+# Filtering
+
+FastGQL extends the GraphQL schema adding `filter` input for objects and adding `filter` arguments to the queries and mutations. We can use the `filter` argument in our queries to filter results based on the field's values. FastGQL allows to add multiple filters with `AND`, `OR`, `NOT` and even nested object filters.
+
+## Simple Operators
+
+fetch posts with where `id == 3`
+
+```graphql
+query {
+ posts(limit: 3, filter: { id: { eq: 3 } }) {
+ id
+ }
+}
+```
+
+## Logical filters
+
+#### AND filter
+
+By default, a logical `AND` operation is preformed on all the conditions mentioned in the filter clause. If we want to use the same field key, than we need to use the `AND` operator in the GraphQL query.
+
+
+
+ ```graphql
+ query {
+ # expected filter: name = "article 1" AND id = 1
+ posts(filter: {name: {eq: "article 1"}, id: {eq: 1}}) {
+ id
+ name
+ }
+ }
+ ```
+
+
+ ```graphql
+ query {
+ # expected filter: name = "article 1" AND name like "%article%" AND id = 1
+ posts(filter: { AND: [ {name: {eq: "article 1"}}, {name: {like: "%article%"}}, {id: {eq: 1}}]}) {
+ id
+ name
+ }
+ }
+ ```
+
+
+
+#### OR filter
+
+To perform a logical `OR` operation, we have to use the `OR` operator in the GraphQL query.
+
+If we would like to fetch information of all post's name that start with the prefix `a` or `b` the following query will return the desired result:
+
+```graphql
+query {
+ posts(
+ filter: { OR: [{ name: { prefix: "a" } }, { name: { suffix: "b" } }] }
+ ) {
+ id
+ name
+ }
+}
+```
+
+#### NOT filter
+
+To perform a logical `NOT`operation, we have to use the `NOT`operator in the GraphQL query.
+
+if we would like to fetch information of all post's name that **don't** start with "a" or ends with "b". the following query will return the desired result:
+
+```graphql
+query {
+ posts(
+ filter: {
+ NOT: { OR: [{ name: { prefix: "a" } }, { name: { suffix: "b" } }] }
+ }
+ ) {
+ id
+ name
+ }
+}
+```
+
+#### Nested filters
+
+We can also perform complex nested logical operation, such as `OR` inside an `AND` operator. The following query will result the following filter:
+
+```sql
+(name like 'b%' OR name like 'a%') AND name like '%c%'
+```
+
+```graphql
+query {
+ posts(
+ filter: {
+ AND: [
+ { OR: [{ name: { prefix: "a" } }, { name: { suffix: "b" } }] }
+ { name: { like: "%c%" } }
+ ]
+ }
+ ) {
+ id
+ name
+ }
+}
+```
+
+## Object Filters
+
+Most objects in our schema usually have fields that aren't `scalars`, and we would like to filter by thier fields. In our example each post has one or more categories we would want to filter posts by some category name. The following GraphQL query will filter for us those posts that have a category name called "Security"
+
+```graphql
+query ObjectFilterExample {
+ posts(filter: {categories: {name: {eq: "Security"}}}) {
+ id
+ name
+ }
+}
+```
diff --git a/docs/src/content/docs/schema/directives.md b/docs/src/content/docs/schema/directives.md
index 95f55d5..bbaf448 100644
--- a/docs/src/content/docs/schema/directives.md
+++ b/docs/src/content/docs/schema/directives.md
@@ -1,147 +1,139 @@
----
-title: Directives
-description: fastGQL supported directives
----
-
-In this section we will go over all of the custom _fastGQL_ directives, what they do and how to use them. These directives are added automatically when we augment and generate the server code. You can also use the following command `go run github.com/roneli/fastgql init` or copy the [fastgql\_schema\_fragment.md](fastgql\_schema\_fragment.md "mention").
-
-## Augmentation directives
-
-These directives extend the original schema functionality adding filters, pagination, aggregation, ordering etc' and are commonly used to tell _fastgql_ what parts of the schema we want to augment.
-
-We currently have four augmentation directives:
-
-* [#generatefilterinput](directives.md#generatefilterinput "mention")
-* [#generate](directives.md#generate "mention")
-* [#skipgenerate](directives.md#skipgenerate "mention")
-* [#generatemutations](directives.md#generatemutations "mention")
-
-
-
-### @generateFilterInput
-
-The `@generateFilterInput` tells the augmenter on which `OBJECT | INTERFACE` to generate filter inputs, this is required so _fastGQL_ knows what objects to build filters for giving you more control over which filters are created.
-
-```graphql
-# Generate filter input on an object
-directive @generateFilterInput(name: String!, description: String)
- on OBJECT | INTERFACE
-```
-
-**Example**:
-
-In this example, we can are creating a filter input for the category type, when arguments will be generated for categories in `Query` the CategoryFilterInput will be used for the `filter` argument.
-
-```graphql
-type Category @generateFilterInput(name: "CategoryFilterInput"){
- id: Int!
- name: String
-}
-
-type Query @generate {
- categories: [Category]
-}
-```
-
-This also works for objects that contain fields of objects, see [Object filters](../../../queries/filter/#object-filters)
-
-### @generate
-
-The `@generate` tells the augmenter on which `OBJECT` to generate arguments i.e. filter, pagination and ordering, aggregation. By default, all arguments are created, and are recursive, this means that arguments are generated from the top level `OBJECT` until exhausted meaning no new OBJECT fields are found in a certain level.
-
-```graphql
-# Generate arguments for a given field or all object fields
-directive @generate(filter: Boolean = True,
- pagination: Boolean = True, ordering: Boolean = True,
- aggregate: Boolean = True, recursive: Boolean = True) on OBJECT
-```
-
-**Example**: The following example adds arguments to all fields in Query and does the same for each field type.
-
-```graphql
-type Query @generate {
- posts: [Post]
- users: [User]
- categories: [Category] @skipGenerate
-}
-```
-
-### @skipGenerate
-
-The `@skipGenerate` tells the codegen whether we want to skip creating the resolver code or not.
-
-```graphql
-# Tells fastgql to skip resolver generation on field
-directive @skipGenerate(resolver:Boolean = True) on FIELD_DEFINITION
-```
-
-**Example:**
-
-```graphql
-
-# Generate augmentation on posts and users, but skip categories
-type Query @generate {
- posts: [Post]
- users: [User]
- categories: [Category] @skipGenerate
-}
-```
-
-### @generateMutations
-
-The `@generateMutations` tells the augmenter on which `OBJECT` to generate mutations on.
-There are 3 possible mutations, create, update and delete, by default all of them are set to true.
-
-```graphql
-# Generate filter input on an object
-directive @generateMutations(create: Boolean = True, delete: Boolean = True, update: Boolean = True) on OBJECT
-```
-
-## Builder directives
-
-Builder directives are used by builders to build queries based on the given GraphQL query requested.
-
-We have two builder directives:
-
-* [#table](directives.md#table "mention")
-* [#relation](directives.md#relation "mention")
-
-### @table
-
-The `@table` directive is used to define the name of the table of the graphql `OBJECT` in the database.
-
-By default, the table name is the name of type, we use this directive when the table name is different from the object typename.
-
-If our table resides in a schema that isn't the one set as the default we need to add the schema argument.
-
-```graphql
-# Used if Object/Interface type name is different then the actual table name or if the table resides in a schema other than default path.
-directive @table(name: String!, dialect: String, schema: String) on OBJECT | INTERFACE
-```
-
-**Example:**
-
-```graphql
-
-type User @table(name: "users", dialect: "postgres", schema: "app"){
- id: Int
- name: String
-}
-```
-
-### @relation
-
-The `@relation` directive tells the builder about relations in your database.
-
-```graphql
-directive @relation(type: _relationType!, fields: [String!]!, references: [String!]!, manyToManyTable: String = "",
- manyToManyFields: [String] = [], manyToManyReferences: [String] = []) on FIELD_DEFINITION
-```
-
-#### Table Relationships
-
-There are three major types of database relationships:
-
-* `ONE_TO_ONE`
-* `ONE_TO_MANY`
-* `MANY_TO_MANY`
+---
+title: Directives
+description: fastGQL supported directives
+---
+
+In this section we will go over all the custom _fastGQL_ directives, what they do and how to use them. These directives are added automatically when we augment and generate the server code. You can also use the following command `go run github.com/roneli/fastgql init` or copy the [fastgql\_schema\_fragment.md](fastgql\_schema\_fragment.md "mention").
+
+## Augmentation directives
+
+These directives extend the original schema functionality adding filters, pagination, aggregation, ordering etc' and are commonly used to tell _fastgql_ what parts of the schema we want to augment.
+
+We currently have four augmentation directives:
+
+* [#generatefilterinput](directives#generatefilterinput "mention")
+* [#generate](directives#generate "mention")
+* [#generateMutations](directives#generatemutations "mention")
+
+
+
+### @generateFilterInput
+
+The `@generateFilterInput` tells the augmenter on which `OBJECT | INTERFACE` to generate filter inputs, this is required so _fastGQL_ knows what objects to build filters for giving you more control over which filters are created.
+
+```graphql
+# Generate filter input on an object
+directive @generateFilterInput(name: String!, description: String)
+ on OBJECT | INTERFACE
+```
+
+**Example**:
+
+In this example, we can are creating a filter input for the category type, when arguments will be generated for categories in `Query` the CategoryFilterInput will be used for the `filter` argument.
+
+```graphql
+type Category @generateFilterInput(name: "CategoryFilterInput"){
+ id: Int!
+ name: String
+}
+
+type Query @generate {
+ categories: [Category]
+}
+```
+
+This also works for objects that contain fields of objects, see [Object filters](../../../queries/filter/#object-filters)
+
+### @generate
+
+The `@generate` tells the augmenter on which `OBJECT` to generate arguments i.e. filter, pagination and ordering, aggregation. By default, all arguments are created, and are recursive, this means that arguments are generated from the top level `OBJECT` until exhausted meaning no new OBJECT fields are found in a certain level.
+
+```graphql
+# Generate arguments for a given field or all object fields
+directive @generate(filter: Boolean = True,
+ pagination: Boolean = True, ordering: Boolean = True,
+ aggregate: Boolean = True, recursive: Boolean = True, filterTypeName: String) on FIELD_DEFINITION
+```
+
+**Example**: The following example generates resolvers for posts and users, but doesn't add aggregation to users.
+
+```graphql
+type Query {
+ posts: [Post] @generate
+ users: [User] @generate(aggregate: false)
+ categories: [Category]
+}
+```
+
+### @generateMutations
+
+The `@generateMutations` tells the augmenter on which `OBJECT` to generate mutations on.
+There are 3 possible mutations, create, update and delete, by default all of them are set to true.
+
+```graphql
+# Generate filter input on an object
+directive @generateMutations(create: Boolean = True, delete: Boolean = True, update: Boolean = True) on OBJECT
+```
+
+## Builder directives
+
+Builder directives are used by builders to build queries based on the given GraphQL query requested.
+
+We have two builder directives:
+
+* [#table](directives#table "mention")
+* [#relation](directives#relation "mention")
+* [#typename](directives#typename "mention")
+
+### @table
+
+The `@table` directive is used to define the name of the table of the graphql `OBJECT` in the database.
+
+By default, the table name is the name of type, we use this directive when the table name is different from the object typename.
+
+If our table resides in a schema that isn't the one set as the default we need to add the schema argument.
+
+```graphql
+# Used if Object/Interface type name is different then the actual table name or if the table resides in a schema other than default path.
+directive @table(name: String!, dialect: String, schema: String) on OBJECT | INTERFACE
+```
+
+**Example:**
+
+```graphql
+
+type User @table(name: "users", dialect: "postgres", schema: "app"){
+ id: Int
+ name: String
+}
+```
+
+### @relation
+
+The `@relation` directive tells the builder about relations in your database.
+
+```graphql
+directive @relation(type: _relationType!, fields: [String!]!, references: [String!]!, manyToManyTable: String = "",
+ manyToManyFields: [String] = [], manyToManyReferences: [String] = []) on FIELD_DEFINITION
+```
+
+#### Table Relationships
+
+There are three major types of database relationships:
+
+* `ONE_TO_ONE`
+* `ONE_TO_MANY`
+* `MANY_TO_MANY`
+
+### @typename
+
+The `@typename` directive is used for interface support (experimental), the typename tell fastgql builder what field in the table we should use
+to use when scanning into the original type of the interface
+
+```graphql
+interface Animal @table(name: "animals") @typename(name: "type") @generateFilterInput {
+ id: Int!
+ name: String!
+ type: String!
+}
+```
\ No newline at end of file
diff --git a/docs/src/content/docs/schema/interfaces.md b/docs/src/content/docs/schema/interfaces.md
new file mode 100644
index 0000000..7b1e0be
--- /dev/null
+++ b/docs/src/content/docs/schema/interfaces.md
@@ -0,0 +1,8 @@
+---
+title: Interfaces
+description: fastGQL interface type
+---
+
+GraphQL support interfaces, most graphql
+
+## Interface Example
\ No newline at end of file
diff --git a/docs/src/content/docs/schema/fastgql_schema_fragment.md b/docs/src/content/docs/schema/schema.md
similarity index 58%
rename from docs/src/content/docs/schema/fastgql_schema_fragment.md
rename to docs/src/content/docs/schema/schema.md
index fcdc8f8..85222a1 100644
--- a/docs/src/content/docs/schema/fastgql_schema_fragment.md
+++ b/docs/src/content/docs/schema/schema.md
@@ -1,127 +1,144 @@
----
-title: FastGQL Schema Fragment
-description: fastGQL schema fragment
----
-# FastGQL Schema Fragment
-
-While editing your schema, you might find it useful to include this GraphQL schema
-fragment. It sets up the definitions of the directives, etc.
-(like @generate) that you’ll use in your schema.
-If your editor is GraphQL aware, it may give you errors if you don’t have
-this available.
-
-```graphql
-
-# Table directive is defined on OBJECTS, if no table directive is defined defaults are assumed
-# i.e , "postgres", ""
-directive @table(name: String!, dialect: String! = "postgres", schema: String = "") on OBJECT | INTERFACE
-
-# Relation directive defines relations cross tables and dialects
-directive @relation(type: _relationType!, fields: [String!]!, references: [String!]!, manyToManyTable: String = "", manyToManyFields: [String] = [], manyToManyReferences: [String] = []) on FIELD_DEFINITION
-
-# used to skip generate on a certain field, this should be used if we use recursive = True in @generate
-directive @skipGenerate(resolver: Boolean = True) on FIELD_DEFINITION
-
-# Generate filter input on an object
-directive @generateFilterInput(name: String!, description: String) repeatable on OBJECT | INTERFACE
-
-# Generate arguments for a given field or all object fields
-directive @generate(filter: Boolean = True, pagination: Boolean = True, ordering: Boolean = True, aggregate: Boolean = True,
- recursive: Boolean = True, wrapper:Boolean = False) repeatable on OBJECT
-
-# Generate mutations object
-directive @generateMutations(create: Boolean = True, delete: Boolean = True, update: Boolean = True) on OBJECT
-
-enum _relationType {
- ONE_TO_ONE
- ONE_TO_MANY
- MANY_TO_MANY
-}
-
-enum _OrderingTypes {
- ASC
- DESC
- ASC_NULL_FIRST
- DESC_NULL_FIRST
-}
-
-type _AggregateResult {
- count: Int!
-}
-
-input StringComparator {
- eq: String
- neq: String
- contains: [String]
- notContains: [String]
- like: String
- ilike: String
- suffix: String
- prefix: String
- isNull: Boolean
-}
-
-input StringListComparator {
- eq: [String]
- neq: [String]
- contains: [String]
- containedBy: [String]
- overlap: [String]
- isNull: Boolean
-}
-
-input IntComparator {
- eq: Int
- neq: Int
- gt: Int
- gte: Int
- lt: Int
- lte: Int
- isNull: Boolean
-}
-
-input IntListComparator {
- eq: [Int]
- neq: [Int]
- contains: [Int]
- contained: [Int]
- overlap: [Int]
- isNull: Boolean
-}
-
-input FloatComparator {
- eq: Float
- neq: Float
- gt: Float
- gte: Float
- lt: Float
- lte: Float
- isNull: Boolean
-}
-
-input FloatListComparator {
- eq: [Float]
- neq: [Float]
- contains: [Float]
- contained: [Float]
- overlap: [Float]
- isNull: Boolean
-}
-
-
-input BooleanComparator {
- eq: Boolean
- neq: Boolean
- isNull: Boolean
-}
-
-input BooleanListComparator {
- eq: [Boolean]
- neq: [Boolean]
- contains: [Boolean]
- contained: [Boolean]
- overlap: [Boolean]
- isNull: Boolean
-}
-
+---
+title: FastGQL Schema Fragment
+description: fastGQL schema fragment
+---
+
+While editing your schema, you might find it useful to include this GraphQL schema
+fragment. It sets up the definitions of the directives, etc.
+(like @generate) that you’ll use in your schema.
+If your editor is GraphQL aware, it may give you errors if you don’t have
+this available.
+
+### Fragment
+
+```graphql
+
+# ================== schema generation fastgql directives ==================
+
+# Generate Resolver directive tells fastgql to generate an automatic resolver for a given field
+# @generateResolver can only be defined on Query and Mutation fields.
+# adding pagination, ordering, aggregate, filter to false will disable the generation of the corresponding arguments
+# for filter to work @generateFilterInput must be defined on the object, if its missing you will get an error
+# recursive will generate pagination, filtering, ordering and aggregate for all the relations of the object,
+# this will modify the object itself and add arguments to the object fields.
+directive @generate(filter: Boolean = True, pagination: Boolean = True, ordering: Boolean = True, aggregate: Boolean = True, recursive: Boolean = True, F: String) on FIELD_DEFINITION
+
+# Generate mutations for an object
+directive @generateMutations(create: Boolean = True, delete: Boolean = True, update: Boolean = True) on OBJECT
+
+# Generate filter input on an object
+directive @generateFilterInput(description: String) repeatable on OBJECT | INTERFACE
+
+directive @isInterfaceFilter on INPUT_FIELD_DEFINITION
+
+# ================== Directives supported by fastgql for Querying ==================
+
+# Table directive is defined on OBJECTS, if no table directive is defined defaults are assumed
+# i.e , "postgres", ""
+directive @table(name: String!, dialect: String! = "postgres", schema: String = "") on OBJECT | INTERFACE
+
+# Relation directive defines relations cross tables and dialects
+directive @relation(type: _relationType!, fields: [String!]!, references: [String!]!, manyToManyTable: String = "", manyToManyFields: [String] = [], manyToManyReferences: [String] = []) on FIELD_DEFINITION
+
+# This will make the field skipped in select, this is useful for fields that are not columns in the database, and you want to resolve it manually
+directive @fastgqlField(skipSelect: Boolean = True) on FIELD_DEFINITION
+
+# Typename is the field name that will be used to resolve the type of the interface,
+# default model is the default model that will be used to resolve the interface if none is found.
+directive @typename(name: String!) on INTERFACE
+
+# =================== Default Scalar types supported by fastgql ===================
+scalar Map
+# ================== Default Filter input types supported by fastgql ==================
+
+enum _relationType {
+ ONE_TO_ONE
+ ONE_TO_MANY
+ MANY_TO_MANY
+}
+
+enum _OrderingTypes {
+ ASC
+ DESC
+ ASC_NULL_FIRST
+ DESC_NULL_FIRST
+ ASC_NULL_LAST
+ DESC_NULL_LAST
+}
+
+input StringComparator {
+ eq: String
+ neq: String
+ contains: [String]
+ notContains: [String]
+ like: String
+ ilike: String
+ suffix: String
+ prefix: String
+ isNull: Boolean
+}
+
+input StringListComparator {
+ eq: [String]
+ neq: [String]
+ contains: [String]
+ containedBy: [String]
+ overlap: [String]
+ isNull: Boolean
+}
+
+input IntComparator {
+ eq: Int
+ neq: Int
+ gt: Int
+ gte: Int
+ lt: Int
+ lte: Int
+ isNull: Boolean
+}
+
+input IntListComparator {
+ eq: [Int]
+ neq: [Int]
+ contains: [Int]
+ contained: [Int]
+ overlap: [Int]
+ isNull: Boolean
+}
+
+input FloatComparator {
+ eq: Float
+ neq: Float
+ gt: Float
+ gte: Float
+ lt: Float
+ lte: Float
+ isNull: Boolean
+}
+
+input FloatListComparator {
+ eq: [Float]
+ neq: [Float]
+ contains: [Float]
+ contained: [Float]
+ overlap: [Float]
+ isNull: Boolean
+}
+
+
+input BooleanComparator {
+ eq: Boolean
+ neq: Boolean
+ isNull: Boolean
+}
+
+input BooleanListComparator {
+ eq: [Boolean]
+ neq: [Boolean]
+ contains: [Boolean]
+ contained: [Boolean]
+ overlap: [Boolean]
+ isNull: Boolean
+}
+
```
\ No newline at end of file
diff --git a/docs/src/styles/global.css b/docs/src/styles/global.css
new file mode 100644
index 0000000..95ab50f
--- /dev/null
+++ b/docs/src/styles/global.css
@@ -0,0 +1,10 @@
+
+@import url('https://fonts.googleapis.com/css2?family=Noto+Sans:ital,wght@0,100;0,200;0,300;0,400;0,500;0,600;0,700;0,800;0,900;1,100;1,200;1,300;1,400;1,500;1,600;1,700;1,800;1,900&display=swap');
+
+:root {
+ --sl-font: 'Noto Sans', serif !important;
+}
+
+.card {
+ border-radius: 0.5rem;
+}
\ No newline at end of file
diff --git a/docs/src/styles/index.css b/docs/src/styles/index.css
new file mode 100644
index 0000000..21bb141
--- /dev/null
+++ b/docs/src/styles/index.css
@@ -0,0 +1,2 @@
+@import "global.css";
+@import "theme.css";
\ No newline at end of file
diff --git a/docs/src/styles/landing.css b/docs/src/styles/landing.css
new file mode 100644
index 0000000..6255a87
--- /dev/null
+++ b/docs/src/styles/landing.css
@@ -0,0 +1,45 @@
+:root {
+ --red-hsl: 10, 80%, 40%;
+ --overlay-blured: hsla(var(--red-hsl), 0.2);
+}
+
+:root[data-theme='light'] {
+ --red-hsl: 5, 85%, 65%;
+}
+
+[data-has-hero] .page {
+ background:
+ linear-gradient(215deg, var(--overlay-blured), transparent 40%),
+ radial-gradient(var(--overlay-blured), transparent 40%) no-repeat -60vw -40vh / 105vw 200vh,
+ radial-gradient(var(--overlay-blured), transparent 65%) no-repeat 50% calc(100% + 20rem) /
+ 60rem 30rem;
+}
+
+[data-has-hero] header {
+ border-bottom: 1px solid transparent;
+ background-color: transparent;
+ -webkit-backdrop-filter: blur(16px);
+ backdrop-filter: blur(16px);
+}
+
+[data-has-hero] .hero > img {
+ filter: drop-shadow(0 0 3rem var(--overlay-blured));
+}
+
+
+/* Default style for light logo */
+.logo {
+ width: 400px; /* Set your desired width */
+ height: auto; /* Maintain aspect ratio */
+ overflow: hidden; /* Hide overflowing parts */
+}
+
+/* Conditional style for dark logo */
+[data-theme='dark'] .logo {
+ content: url('/src/assets/logo_dark.svg');
+}
+
+/* Hide the default image when the dark theme is active */
+[data-theme='light'] .logo {
+ content: url('/src/assets/logo_light.svg');
+}
\ No newline at end of file
diff --git a/docs/src/styles/overrides.css b/docs/src/styles/overrides.css
new file mode 100644
index 0000000..b3c2a0f
--- /dev/null
+++ b/docs/src/styles/overrides.css
@@ -0,0 +1,39 @@
+@font-face {
+ font-family: GreekCesarFont;
+ src: url("/src/assets/fonts/Interfearence.ttf");
+}
+
+.roller {
+ max-width:600vw; /* Set a width that can accommodate the longest text string */
+ white-space: nowrap; /* Prevent the text from wrapping */
+ overflow: hidden; /* Hide the overflowed text */
+}
+
+#changing_text {
+ text-transform: uppercase;
+ font-family: GreekCesarFont, serif;
+ background: linear-gradient(45deg, #ff4500, #ff8c00);
+ -webkit-background-clip: text;
+ -webkit-text-fill-color: transparent;;
+ font-size: 0.9em;
+}
+
+
+@keyframes animate {
+ 0% {
+ opacity: 1;
+ }
+
+ 50% {
+ opacity: 0;
+ }
+
+ 100% {
+ opacity: 1;
+ }
+}
+
+
+.hero {
+ padding-bottom: 3.5rem !important;
+}
\ No newline at end of file
diff --git a/docs/src/styles/theme.css b/docs/src/styles/theme.css
new file mode 100644
index 0000000..e29ec0d
--- /dev/null
+++ b/docs/src/styles/theme.css
@@ -0,0 +1,19 @@
+[data-theme="light"] {
+ --color-primary: theme("colors.pink.500");
+ --color-secondary: theme("colors.indigo.500");
+ --color-text: theme("colors.gray.900");
+ --color-text-offset: theme("colors.gray.600");
+ --color-background: theme("colors.gray.50");
+ --color-background-offset: theme("colors.gray.100");
+ --color-border: theme("colors.gray.900" / 10%);
+}
+
+[data-theme="dark"] {
+ --color-primary: theme("colors.pink.400");
+ --color-secondary: theme("colors.indigo.400");
+ --color-text: theme("colors.gray.50");
+ --color-text-offset: theme("colors.gray.400");
+ --color-background: theme("colors.gray.900");
+ --color-background-offset: theme("colors.gray.800");
+ --color-border: theme("colors.gray.50" / 10%);
+}
\ No newline at end of file
diff --git a/docs/src/utils/roller.js b/docs/src/utils/roller.js
new file mode 100644
index 0000000..529c3bc
--- /dev/null
+++ b/docs/src/utils/roller.js
@@ -0,0 +1,69 @@
+document.addEventListener('DOMContentLoaded', (event) => {
+ const letters = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+ const word = document.querySelector("#changing_text");
+ const texts = [
+ "Auto-generate CRUD operations",
+ "Supports with Interface Types",
+ "Custom filter operators",
+ "Easily extend with custom code"
+ ];
+ let textIndex = 0;
+
+ let isAnimating = false;
+ let rafID;
+ let then = Date.now();
+ const interval = 15;
+
+ const animate = () => {
+ isAnimating = true;
+ let iterations = 0;
+ const originalText = texts[textIndex];
+
+ const changeLetter = () => {
+ let now = Date.now();
+ let elapsed = now - then;
+
+ if (elapsed > interval) {
+ word.innerText = originalText
+ .split("")
+ .map((letter, index) => {
+ if (index < iterations) {
+ return originalText[index];
+ }
+ if (letter == " ") {
+ return " ";
+ }
+ return letters[Math.floor(Math.random() * 22)];
+ })
+ .join("");
+
+ iterations += 1 / 3;
+ then = now - (elapsed % interval);
+ }
+
+ if (iterations < word.innerText.length && isAnimating) {
+ rafID = requestAnimationFrame(changeLetter);
+ }
+ }
+
+ rafID = requestAnimationFrame(changeLetter);
+ }
+
+ animate();
+
+ setInterval(() => {
+ textIndex = (textIndex + 1) % texts.length;
+ if (!document.hidden) {
+ animate();
+ }
+ }, 4000);
+
+ document.addEventListener('visibilitychange', function() {
+ if (document.hidden) {
+ isAnimating = false;
+ cancelAnimationFrame(rafID);
+ } else {
+ animate();
+ }
+ });
+});
\ No newline at end of file
diff --git a/docs/tailwind.config.mjs b/docs/tailwind.config.mjs
new file mode 100644
index 0000000..9fb4456
--- /dev/null
+++ b/docs/tailwind.config.mjs
@@ -0,0 +1,31 @@
+const defaultTheme = require("tailwindcss/defaultTheme");
+
+module.exports = {
+ content: ["./src/**/*.{astro,html,js,jsx,svelte,ts,tsx,vue,mdx}"],
+ theme: {
+ extend: {
+ fontFamily: {
+ sans: ["Inter Variable", ...defaultTheme.fontFamily.sans],
+ },
+ colors: {
+ primary: "var(--color-primary)",
+ secondary: "var(--color-secondary)",
+ },
+ textColor: {
+ default: "var(--color-text)",
+ offset: "var(--color-text-offset)",
+ },
+ backgroundColor: {
+ default: "var(--color-background)",
+ offset: "var(--color-background-offset)",
+ },
+ borderColor: {
+ default: "var(--color-border)",
+ },
+ },
+ },
+ corePlugins: {
+ fontSize: false,
+ },
+ plugins: [require("tailwindcss-fluid-type")],
+};
\ No newline at end of file
diff --git a/docs/tsconfig.json b/docs/tsconfig.json
index ebbe6d1..a88c4dd 100644
--- a/docs/tsconfig.json
+++ b/docs/tsconfig.json
@@ -1,3 +1,12 @@
-{
- "extends": "astro/tsconfigs/strict"
+{
+ "extends": "astro/tsconfigs/strict",
+ "compilerOptions": {
+ // Alias `src` to `~`
+ "baseUrl": ".",
+ "paths": {
+ "~/*": ["src/*"],
+ "@components/*": ["src/components/*"],
+ "@assets/*": ["src/assets/*"]
+ }
+ }
}
\ No newline at end of file
diff --git a/examples/interface/graph/schema.graphql b/examples/interface/graph/schema.graphql
index 836c833..8d6fa58 100644
--- a/examples/interface/graph/schema.graphql
+++ b/examples/interface/graph/schema.graphql
@@ -1,39 +1,40 @@
-interface Animal @table(name: "animals") @typename(name: "type") @generateFilterInput {
- id: Int!
- name: String!
- type: String!
-}
-type Cat implements Animal {
- id: Int!
- name: String!
- type: String!
- color: String!
-}
-type Category @generateFilterInput @table(name: "categories") {
- id: Int!
- name: String
-}
-type Dog implements Animal {
- id: Int!
- name: String!
- type: String!
- breed: String!
-}
-type Post @generateFilterInput @table(name: "posts") {
- id: Int!
- name: String
- categories: [Category] @relation(type: MANY_TO_MANY, fields: ["id"], references: ["id"], manyToManyTable: "posts_to_categories", manyToManyFields: ["post_id"], manyToManyReferences: ["category_id"])
- user_id: Int
- user: User @relation(type: ONE_TO_ONE, fields: ["user_id"], references: ["id"])
-}
-type Query {
- posts: [Post] @generate
- users: [User] @generate
- categories: [Category] @generate
- animals: [Animal] @generate
-}
-type User @table(name: "user") @generateFilterInput {
- id: Int!
- name: String!
- posts: [Post] @relation(type: ONE_TO_MANY, fields: ["id"], references: ["user_id"])
-}
+interface Animal @table(name: "animals") @typename(name: "type") @generateFilterInput {
+ id: Int!
+ name: String!
+ type: String!
+}
+
+type Cat implements Animal {
+ id: Int!
+ name: String!
+ type: String!
+ color: String!
+}
+type Category @generateFilterInput @table(name: "categories") {
+ id: Int!
+ name: String
+}
+type Dog implements Animal {
+ id: Int!
+ name: String!
+ type: String!
+ breed: String!
+}
+type Post @generateFilterInput @table(name: "posts") {
+ id: Int!
+ name: String
+ categories: [Category] @relation(type: MANY_TO_MANY, fields: ["id"], references: ["id"], manyToManyTable: "posts_to_categories", manyToManyFields: ["post_id"], manyToManyReferences: ["category_id"])
+ user_id: Int
+ user: User @relation(type: ONE_TO_ONE, fields: ["user_id"], references: ["id"])
+}
+type Query {
+ posts: [Post] @generate
+ users: [User] @generate
+ categories: [Category] @generate
+ animals: [Animal] @generate
+}
+type User @table(name: "user") @generateFilterInput {
+ id: Int!
+ name: String!
+ posts: [Post] @relation(type: ONE_TO_MANY, fields: ["id"], references: ["user_id"])
+}
-
- 
-
-