@directus/app 9.16.0 → 9.17.1

package/dist/assets/{insights.0f2b188e.js → insights.c3df1bb3.js}

@@ -1,2 +1,2 @@
-import{a as i,o as d,b as u,w as t,g as e,e as a,B as l}from"./runtime-core.esm-bundler.e3d5f5b7.js";const h={class:"markdown-body"},c=e("blockquote",null,[e("p",null,[l("Insights is a Module in Directus that allows rapid, no-code build-out of analytics dashboards. Regardless of your use-case "),e("em",null,"(be it business intelligence, user progress tracking, web traffic conversions, or whatever!)"),l(" you will be able to setup key data metrics in just a few clicks.")])],-1),g=e("video",{autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[e("source",{src:"https://cdn.directus.io/docs/v9/app-guide/insights/insights-20220216A/insights-dashboards-20220216A.mp4",type:"video/mp4"})],-1),p=e("h2",{id:"how-it-works",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#how-it-works"},"#"),l(" How it Works")],-1),m=e("video",{autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[e("source",{src:"https://cdn.directus.io/docs/v9/app-guide/insights/insights-20220216A/insights-how-it-works-20220216A_1.mp4",type:"video/mp4"})],-1),b=e("p",null,"First, create a Dashboard, then fill the Dashboard with Panels.",-1),_=e("ol",null,[e("li",null,[l("Click the \u201CCreate Dashboard\u201D action button "),e("span",{mi:"",btn:""},"add"),l(" in the page header.")]),e("li",null,"Fill in the dashboard name, icon and note."),e("li",null,"Click \u201CSave\u201D."),e("li",null,"Click the edit icon in the page header."),e("li",null,[l("Hit the \u201CCreate Panel\u201D "),e("span",{mi:"",btn:""},"add"),l(" in the page header.")]),e("li",null,[l("Select a Panel type. "),e("a",{href:"#panels-overview"},"Learn More about panel types.")]),e("li",null,"Adjust the Panel Options to customize the analytics metric."),e("li",null,[l("Click "),e("span",{mi:"",btn:""},"check"),l(" in the drawer header to create the panel.")]),e("li",null,[l("Click "),e("span",{mi:"",btn:""},"check"),l(" in the page header to confirm all edits.")])],-1),f=e("h2",{id:"dashboards-overview",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#dashboards-overview"},"#"),l(" Dashboards Overview")],-1),y=e("p",null,[e("img",{src:"https://cdn.directus.io/docs/v9/app-guide/insights/insights-20220216A/dashboards-overview-20220216A.webp",alt:"Dashboard Grid Area"})],-1),v=l("Each Directus Dashboard provides a drag-and-drop canvas where you can create and arrange different Panels to easily build out customized analytics. The Dashboard area automatically expands as you add more and more Panels. In theory, a Dashboard area can expand infinitely large\u2026 but in practice, users will probably only want to build Dashboards as large as the screen they will be viewing on. You are able to create as many Dashboards as you need. Additionally, the Dashboard view, edit, and create permissions are "),w=l("fully configurable"),S=l(" by User Role."),x={class:"tip hint"},A=e("div",{class:"hint-title"},"Auto Refresh",-1),D=l("The Auto Refresh menu in the "),F=l("Sidebar"),I=l(" lets you select an interval to refresh dashboard data."),k=e("h2",{id:"create%2C-edit%2C-and-delete-dashboards",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#create%2C-edit%2C-and-delete-dashboards"},"#"),l(" Create, Edit, and Delete Dashboards")],-1),C=e("p",null,[e("img",{src:"https://cdn.directus.io/docs/v9/app-guide/insights/insights-20220216A/create-edit-delete-dashboards-20220216A.webp",alt:"How to Add, Edit and Delete Dashboards in Directus Insights"})],-1),P=e("ol",null,[e("li",null,[l("Click the "),e("span",{mi:"",btn:""},"add"),l(" icon in the page header to create a new Dashboard.")]),e("li",null,"Click the item option to edit or delete a Dashboard.")],-1),T=e("h2",{id:"panels-overview",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#panels-overview"},"#"),l(" Panels Overview")],-1),L=e("p",null,[e("img",{src:"https://cdn.directus.io/docs/v9/app-guide/insights/insights-20220216A/panels-overview-20220216A.webp",alt:"Directus Dashboard Panels"})],-1),M=e("p",null,"Panels are the building-blocks we add onto Insights dashboards to create, save and display data analytics. There are five types of Panels, and each one provides some unique analytics tool.",-1),V=e("ol",null,[e("li",null,[e("strong",null,"Label"),l(" \u2013 Displays simple header text to describe other groups of panels. Doesn\u2019t actually provide data analysis.")]),e("li",null,[e("strong",null,"List"),l(" \u2013 Sortable, filterable list of items within a collection.")]),e("li",null,[e("strong",null,"Metric"),l(" \u2013 Sortable, filterable single-number metrics like sum, average, minimum and maximum, or first and last.")]),e("li",null,[e("strong",null,"Time Series"),l(" \u2013 Graph to display how metrics change over time. Provides same sorting, filtering and aggregation features seen in the list and metric panels.")]),e("li",null,[e("strong",null,"Global Variables"),l(" \u2014 Sets a variable which is globally accessible across other panels.")])],-1),O=e("h2",{id:"panel-header-options",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#panel-header-options"},"#"),l(" Panel Header Options")],-1),G=e("p",null,[e("img",{src:"https://cdn.directus.io/docs/v9/app-guide/insights/insights-20220216A/panel-header-options-20220216A.webp",alt:"Panel Header Options"})],-1),H=e("p",null,"All 4 panel types let you set custom text to provide quick and clear context about what a Panel represents. Panel Header options are exactly the same for all four Panel types. Headers are also totally optional and can be hidden.",-1),q=e("ul",null,[e("li",null,[e("strong",null,"Visible"),l(" \u2013 Determines if the header is visible or not.")]),e("li",null,[e("strong",null,"Name"),l(" \u2013 Sets a name in the header area.")]),e("li",null,[e("strong",null,"Icon"),l(" \u2013 Sets a small icon by the name.")]),e("li",null,[e("strong",null,"Color"),l(" \u2013 Sets a color for the icon.")]),e("li",null,[e("strong",null,"Note"),l(" \u2013 Sets a short description of the icon.")])],-1),N=e("h2",{id:"labels",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#labels"},"#"),l(" Labels")],-1),R=e("p",null,[e("img",{src:"https://cdn.directus.io/docs/v9/app-guide/insights/insights-20220216A/label-panel-options-20220216A.webp",alt:"Label Panel Options"})],-1),W=e("p",null,[l("As the name implies, this panel simply allows you to "),e("em",null,"label"),l(" a group of other panels. Labels do not provide analytics. Labels simply help visually group the other panels ("),e("em",null,"which do provide analytics"),l(") and give context to your dashboard.")],-1),Y=e("ul",null,[e("li",null,[e("strong",null,"Label"),l(" \u2013 Sets the label text.")]),e("li",null,[e("strong",null,"Color"),l(" \u2013 Sets the label text color.")])],-1),E=e("h2",{id:"lists",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#lists"},"#"),l(" Lists")],-1),z=e("p",null,[e("img",{src:"https://cdn.directus.io/docs/v9/app-guide/insights/insights-20220216A/list-panel-options-20220216A.webp",alt:"List Panel Options"})],-1),B=e("p",null,[l("List panels display some number of Items from a Collection, "),e("em",null,"as a list!"),l(" These Items displayed can be filtered by other criteria as well. So for example, you could show your top 5 selling products, 3 worst performing sales regions, 10 students with the highest GPA "),e("em",null,"that are also"),l(" in intramural sports, or create any other kind of ranked and/or filtered list that could be generated from your dataset.")],-1),j=e("ul",null,[e("li",null,[e("strong",null,"Collection"),l(" \u2013 Selects the Collection to rank.")]),e("li",null,[e("strong",null,"Limit"),l(" \u2013 Limits the number of Items that will appear in the Dashboard.")]),e("li",null,[e("strong",null,"Sort Field"),l(" \u2013 Sets the Collection Field you wish to order results by.")]),e("li",null,[e("strong",null,"Sort Direction"),l(" \u2013 Sets Items to display in ascending or descending order.")]),e("li",null,[e("strong",null,"Display Template"),l(" \u2013 Defines how List Items will be represented. Allows use of Field Item values as well as custom text.")]),e("li",null,[e("strong",null,"Filter"),l(" \u2013 Sets filters to only consider and rank Items that meet some criteria.")])],-1),K=e("h2",{id:"metrics",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#metrics"},"#"),l(" Metrics")],-1),U=e("p",null,[e("img",{src:"https://cdn.directus.io/docs/v9/app-guide/insights/insights-20220216A/metric-panel-options-20220216A.webp",alt:"Metrics Panel Options"})],-1),X=e("p",null,"Metrics Panels allow you to aggregate all Items in a Field down to a single value.",-1),J=e("ul",null,[e("li",null,[e("strong",null,"Collection"),l(" \u2013 Selects the Collection.")]),e("li",null,[e("strong",null,"Field"),l(" \u2013 Selects the Field to run aggregate function on.")]),e("li",null,[e("strong",null,"Aggregate Function"),l(" \u2013 Selects the type of aggregate to perform.")]),e("li",null,[e("strong",null,"Sort Field"),l(" \u2013 Sets the collection field you wish to order results by.")]),e("li",null,[e("strong",null,"Filter"),l(" \u2013 Sets filters to only run metrics on Items that meet some criteria.")])],-1),Q=e("h3",{id:"more-on-aggregate-functions",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#more-on-aggregate-functions"},"#"),l(" More on Aggregate Functions")],-1),Z=e("p",null,"Generally speaking, aggregate functions take a list of values and returns one single value.",-1),$=e("ul",null,[e("li",null,[e("strong",null,"Count"),l(" \u2013 Counts the number of Items in a Field.")]),e("li",null,[e("strong",null,"Count (Distinct)"),l(" \u2013 Counts the number of "),e("em",null,"unique"),l(" Items in a field.")]),e("li",null,[e("strong",null,"Average"),l(" \u2013 Averages values of all Items in a Field.")]),e("li",null,[e("strong",null,"Average (Distinct)"),l(" \u2013 Averages values of all "),e("em",null,"unique"),l(" Items in a Field.")]),e("li",null,[e("strong",null,"Sum"),l(" \u2013 Sums the values of all Items in a Field.")]),e("li",null,[e("strong",null,"Sum (Distinct)"),l(" \u2013 Sums the values of all "),e("em",null,"unique"),l(" Items in a Field.")]),e("li",null,[e("strong",null,"Minimum"),l(" \u2013 Selects the lowest valued Item in a Field.")]),e("li",null,[e("strong",null,"Maximum"),l(" \u2013 Selects the highest valued Item in a Field.")]),e("li",null,[e("strong",null,"First"),l(" \u2013 Selects the first Item out of all Items in a Field.")]),e("li",null,[e("strong",null,"Last"),l(" \u2013 Selects the last Item out of all Items in a Field.")])],-1),ee=e("div",{class:"tip hint"},[e("div",{class:"hint-title"},"First, Last, Minimum and Maximum"),e("p",null,"First, Last, Minimum and Maximum are not aggregates in the purely mathematical sense of the word. However, they are placed in this panel option because they return one single Item.")],-1),le=e("div",{class:"tip hint"},[e("div",{class:"hint-title"},"Why are some Fields grayed out?"),e("p",null,[l("Certain Fields cannot be used with certain aggregate functions. For example, you cannot use the average function on Fields that store text, because text cannot be averaged. When there is a conflict between panel options, Fields will be grayed out and unselectable in the "),e("code",null,"field dropdown list"),l(".")])],-1),te=e("h3",{id:"style-and-format-options",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#style-and-format-options"},"#"),l(" Style and Format Options")],-1),se=e("ul",null,[e("li",null,[e("strong",null,"Abbreviate Value"),l(" \u2013 Abbreviates large numbers with a letter "),e("em",null,"(e.g. 2,000 = 2K)"),l(".")]),e("li",null,[e("strong",null,"Decimals"),l(" \u2013 Changes the number of decimals displayed.")]),e("li",null,[e("strong",null,"Prefix"),l(" \u2013 Adds text before the aggregate metric.")]),e("li",null,[e("strong",null,"Suffix"),l(" \u2013 Adds text after the aggregate metric.")]),e("li",null,[e("strong",null,"Conditional Styles"),l(" \u2013 Changes color of number displayed if it is "),e("code",null,">"),l(", "),e("code",null,">="),l(", "),e("code",null,"<"),l(", "),e("code",null,"<="),l(", "),e("code",null,"=="),l(", or "),e("code",null,"!="),l(" to some defined value.")])],-1),ne=e("h2",{id:"time-series",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#time-series"},"#"),l(" Time Series")],-1),ie=e("p",null,[e("img",{src:"https://cdn.directus.io/docs/v9/app-guide/insights/insights-20220216A/time-series-panel-options-20220216A.webp",alt:"Time Series Panel Options"})],-1),ae=e("p",null,"The Time Series Panel allows you to build graphs and see how data changes over time.",-1),oe=e("ul",null,[e("li",null,[e("strong",null,"Collection"),l(" \u2013 Selects the Collection you want to analyze.")]),e("li",null,[e("strong",null,"Color"),l(" \u2013 Sets color of your graph curve.")]),e("li",null,[e("strong",null,"Group Aggregation"),l(" \u2013 Selects the type of aggregation to perform. "),e("a",{href:"#more-on-aggregate-functions"},"Learn more.")]),e("li",null,[e("strong",null,"Group Precision"),l(" \u2013 Sets the time interval to aggregate by "),e("em",null,"(days, weeks, months, etc.)"),l(".")]),e("li",null,[e("strong",null,"Date Field"),l(" \u2013 Selects the datetime Field used along the x-axis.")]),e("li",null,[e("strong",null,"Date Range"),l(" \u2013 Sets the time range from which data should be displayed, can be customized.")]),e("li",null,[e("strong",null,"Value Field"),l(" \u2013 Sets the Field you wish to aggregate.")]),e("li",null,[e("strong",null,"Value Decimals"),l(" \u2013 Changes the number of decimals displayed on the y-axis.")]),e("li",null,[e("strong",null,"Min Value"),l(" \u2013 Sets minimum value displayed on y-axis.")]),e("li",null,[e("strong",null,"Max Value"),l(" \u2013 Sets maximum value displayed on y-axis.")]),e("li",null,[e("strong",null,"Curve Type"),l(" \u2013 Sets curve to be shown as smooth, straight or stepline.")]),e("li",null,[e("strong",null,"Fill Type"),l(" \u2013 Sets fill type under curve to gradient, solid, or none.")]),e("li",null,[e("strong",null,"Filter"),l(" \u2013 Allows filtering of Items considered for analysis based on logical conditions.")]),e("li",null,[e("strong",null,"Show X-axis"),l(" \u2013 Toggles display of time along X-axis.")]),e("li",null,[e("strong",null,"Show Y-axis"),l(" \u2013 Toggles display of numeric values along Y-axis.")])],-1),re=e("div",{class:"warning hint"},[e("div",{class:"hint-title"},"Time-oriented metrics only"),e("p",null,"In order to use this Panel, your Collection will need a datetime Field.")],-1),de=e("div",{class:"tip hint"},[e("div",{class:"hint-title"},"Custom Date Range"),e("p",null,[l("Note that "),e("code",null,"Past"),l(" is not prefixed to a custom range as it is on the default ranges. When selecting "),e("strong",null,"\u201COther\u201D"),l(", simply type in "),e("code",null,"3 years"),l(", "),e("code",null,"1 month"),l(", "),e("code",null,"2 weeks"),l(", "),e("code",null,"5 days"),l(", etc.")])],-1),ue=e("h2",{id:"global-variable",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#global-variable"},"#"),l(" Global Variable")],-1),he=e("p",null,[e("img",{src:"https://cdn.directus.io/docs/v9/app-guide/insights/insights-220624A/global-variable-220624A.webp",alt:"Global Variables"})],-1),ce=e("ul",null,[e("li",null,[e("strong",null,"Variable Key"),l(" \u2014 Sets your variable. Use this key to access the variable in other Insights panels.")]),e("li",null,[e("strong",null,"Type"),l(" \u2014 Sets the data type of your variable.")]),e("li",null,[e("strong",null,"Default Value"),l(" \u2014 Sets a default value for the global variable.")]),e("li",null,[e("strong",null,"Interface"),l(" \u2014 Selects the Interface to be used.")]),e("li",null,[e("strong",null,"Options"),l(" \u2014 Sets the Interface Options.")])],-1),ge=e("p",null,"This panel allows you to create a variable which is globally accessible across other panels. You can use this to do things like create a string or number to prefix other Insights Panel titles or pass it as a value into a Filter to query results.",-1),pe=e("p",null,[l("To create and assign a Global Variable, follow the steps from "),e("a",{href:"#how-it-works"},"How it Works"),l(", selecting the Global Variable panel. Wrap the variable key in double-moustache syntax to access and assign it throughout other Insights Panels:")],-1),me=e("pre",null,[e("code",null,`{{ your_variable_key }}
-`)],-1),be=e("p",null,"You will notice that the Global Variable Panel is an interface in the Dashboard, allowing you to modify the value of this variable. If you change its value, all panels referencing the variable will update automatically.",-1),_e=e("div",{class:"warning hint"},[e("div",{class:"hint-title"},"Must be Valid Data Type"),e("p",null,"Your variable\u2019s data type will need to be a valid match to wherever you are using it. For example, do not apply a string or JSON variable in a place that requires Datetime data.")],-1),Se="Insights",xe=!1,Ae="Insights is a Module in Directus that allows rapid, no-code build-out of analytics dashboards.",De="9 min read",Fe={name:"insights",setup(fe,{expose:o}){const s={title:"Insights",modularExtension:!1,description:"Insights is a Module in Directus that allows rapid, no-code build-out of analytics dashboards.",readTime:"9 min read"};return o({frontmatter:s}),(ye,ve)=>{const n=i("router-link"),r=i("docs-wrapper");return d(),u(r,{frontmatter:s},{default:t(()=>[e("div",h,[c,g,p,m,b,_,f,y,e("p",null,[v,a(n,{to:"/docs/configuration/users-roles-permissions"},{default:t(()=>[w]),_:1}),S]),e("div",x,[A,e("p",null,[D,a(n,{to:"/docs/app/overview#_4-sidebar"},{default:t(()=>[F]),_:1}),I])]),k,C,P,T,L,M,V,O,G,H,q,N,R,W,Y,E,z,B,j,K,U,X,J,Q,Z,$,ee,le,te,se,ne,ie,ae,oe,re,de,ue,he,ce,ge,pe,me,be,_e])]),_:1})}}};export{Fe as default,Ae as description,xe as modularExtension,De as readTime,Se as title};
+import{a as i,o as d,b as u,w as t,l as e,e as a,E as l}from"./runtime-core.esm-bundler.32cac88a.js";const h={class:"markdown-body"},c=e("blockquote",null,[e("p",null,[l("Insights is a Module in Directus that allows rapid, no-code build-out of analytics dashboards. Regardless of your use-case "),e("em",null,"(be it business intelligence, user progress tracking, web traffic conversions, or whatever!)"),l(" you will be able to setup key data metrics in just a few clicks.")])],-1),g=e("video",{autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[e("source",{src:"https://cdn.directus.io/docs/v9/app-guide/insights/insights-20220216A/insights-dashboards-20220216A.mp4",type:"video/mp4"})],-1),p=e("h2",{id:"how-it-works",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#how-it-works"},"#"),l(" How it Works")],-1),m=e("video",{autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[e("source",{src:"https://cdn.directus.io/docs/v9/app-guide/insights/insights-20220216A/insights-how-it-works-20220216A_1.mp4",type:"video/mp4"})],-1),b=e("p",null,"First, create a Dashboard, then fill the Dashboard with Panels.",-1),_=e("ol",null,[e("li",null,[l("Click the \u201CCreate Dashboard\u201D action button "),e("span",{mi:"",btn:""},"add"),l(" in the page header.")]),e("li",null,"Fill in the dashboard name, icon and note."),e("li",null,"Click \u201CSave\u201D."),e("li",null,"Click the edit icon in the page header."),e("li",null,[l("Hit the \u201CCreate Panel\u201D "),e("span",{mi:"",btn:""},"add"),l(" in the page header.")]),e("li",null,[l("Select a Panel type. "),e("a",{href:"#panels-overview"},"Learn More about panel types.")]),e("li",null,"Adjust the Panel Options to customize the analytics metric."),e("li",null,[l("Click "),e("span",{mi:"",btn:""},"check"),l(" in the drawer header to create the panel.")]),e("li",null,[l("Click "),e("span",{mi:"",btn:""},"check"),l(" in the page header to confirm all edits.")])],-1),f=e("h2",{id:"dashboards-overview",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#dashboards-overview"},"#"),l(" Dashboards Overview")],-1),y=e("p",null,[e("img",{src:"https://cdn.directus.io/docs/v9/app-guide/insights/insights-20220216A/dashboards-overview-20220216A.webp",alt:"Dashboard Grid Area"})],-1),v=l("Each Directus Dashboard provides a drag-and-drop canvas where you can create and arrange different Panels to easily build out customized analytics. The Dashboard area automatically expands as you add more and more Panels. In theory, a Dashboard area can expand infinitely large\u2026 but in practice, users will probably only want to build Dashboards as large as the screen they will be viewing on. You are able to create as many Dashboards as you need. Additionally, the Dashboard view, edit, and create permissions are "),w=l("fully configurable"),S=l(" by User Role."),x={class:"tip hint"},A=e("div",{class:"hint-title"},"Auto Refresh",-1),D=l("The Auto Refresh menu in the "),F=l("Sidebar"),I=l(" lets you select an interval to refresh dashboard data."),k=e("h2",{id:"create%2C-edit%2C-and-delete-dashboards",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#create%2C-edit%2C-and-delete-dashboards"},"#"),l(" Create, Edit, and Delete Dashboards")],-1),C=e("p",null,[e("img",{src:"https://cdn.directus.io/docs/v9/app-guide/insights/insights-20220216A/create-edit-delete-dashboards-20220216A.webp",alt:"How to Add, Edit and Delete Dashboards in Directus Insights"})],-1),P=e("ol",null,[e("li",null,[l("Click the "),e("span",{mi:"",btn:""},"add"),l(" icon in the page header to create a new Dashboard.")]),e("li",null,"Click the item option to edit or delete a Dashboard.")],-1),T=e("h2",{id:"panels-overview",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#panels-overview"},"#"),l(" Panels Overview")],-1),L=e("p",null,[e("img",{src:"https://cdn.directus.io/docs/v9/app-guide/insights/insights-20220216A/panels-overview-20220216A.webp",alt:"Directus Dashboard Panels"})],-1),M=e("p",null,"Panels are the building-blocks we add onto Insights dashboards to create, save and display data analytics. There are five types of Panels, and each one provides some unique analytics tool.",-1),V=e("ol",null,[e("li",null,[e("strong",null,"Label"),l(" \u2013 Displays simple header text to describe other groups of panels. Doesn\u2019t actually provide data analysis.")]),e("li",null,[e("strong",null,"List"),l(" \u2013 Sortable, filterable list of items within a collection.")]),e("li",null,[e("strong",null,"Metric"),l(" \u2013 Sortable, filterable single-number metrics like sum, average, minimum and maximum, or first and last.")]),e("li",null,[e("strong",null,"Time Series"),l(" \u2013 Graph to display how metrics change over time. Provides same sorting, filtering and aggregation features seen in the list and metric panels.")]),e("li",null,[e("strong",null,"Global Variables"),l(" \u2014 Sets a variable which is globally accessible across other panels.")])],-1),O=e("h2",{id:"panel-header-options",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#panel-header-options"},"#"),l(" Panel Header Options")],-1),G=e("p",null,[e("img",{src:"https://cdn.directus.io/docs/v9/app-guide/insights/insights-20220216A/panel-header-options-20220216A.webp",alt:"Panel Header Options"})],-1),H=e("p",null,"All 4 panel types let you set custom text to provide quick and clear context about what a Panel represents. Panel Header options are exactly the same for all four Panel types. Headers are also totally optional and can be hidden.",-1),q=e("ul",null,[e("li",null,[e("strong",null,"Visible"),l(" \u2013 Determines if the header is visible or not.")]),e("li",null,[e("strong",null,"Name"),l(" \u2013 Sets a name in the header area.")]),e("li",null,[e("strong",null,"Icon"),l(" \u2013 Sets a small icon by the name.")]),e("li",null,[e("strong",null,"Color"),l(" \u2013 Sets a color for the icon.")]),e("li",null,[e("strong",null,"Note"),l(" \u2013 Sets a short description of the icon.")])],-1),N=e("h2",{id:"labels",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#labels"},"#"),l(" Labels")],-1),E=e("p",null,[e("img",{src:"https://cdn.directus.io/docs/v9/app-guide/insights/insights-20220216A/label-panel-options-20220216A.webp",alt:"Label Panel Options"})],-1),R=e("p",null,[l("As the name implies, this panel simply allows you to "),e("em",null,"label"),l(" a group of other panels. Labels do not provide analytics. Labels simply help visually group the other panels ("),e("em",null,"which do provide analytics"),l(") and give context to your dashboard.")],-1),W=e("ul",null,[e("li",null,[e("strong",null,"Label"),l(" \u2013 Sets the label text.")]),e("li",null,[e("strong",null,"Color"),l(" \u2013 Sets the label text color.")])],-1),Y=e("h2",{id:"lists",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#lists"},"#"),l(" Lists")],-1),z=e("p",null,[e("img",{src:"https://cdn.directus.io/docs/v9/app-guide/insights/insights-20220216A/list-panel-options-20220216A.webp",alt:"List Panel Options"})],-1),B=e("p",null,[l("List panels display some number of Items from a Collection, "),e("em",null,"as a list!"),l(" These Items displayed can be filtered by other criteria as well. So for example, you could show your top 5 selling products, 3 worst performing sales regions, 10 students with the highest GPA "),e("em",null,"that are also"),l(" in intramural sports, or create any other kind of ranked and/or filtered list that could be generated from your dataset.")],-1),j=e("ul",null,[e("li",null,[e("strong",null,"Collection"),l(" \u2013 Selects the Collection to rank.")]),e("li",null,[e("strong",null,"Limit"),l(" \u2013 Limits the number of Items that will appear in the Dashboard.")]),e("li",null,[e("strong",null,"Sort Field"),l(" \u2013 Sets the Collection Field you wish to order results by.")]),e("li",null,[e("strong",null,"Sort Direction"),l(" \u2013 Sets Items to display in ascending or descending order.")]),e("li",null,[e("strong",null,"Display Template"),l(" \u2013 Defines how List Items will be represented. Allows use of Field Item values as well as custom text.")]),e("li",null,[e("strong",null,"Filter"),l(" \u2013 Sets filters to only consider and rank Items that meet some criteria.")])],-1),K=e("h2",{id:"metrics",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#metrics"},"#"),l(" Metrics")],-1),U=e("p",null,[e("img",{src:"https://cdn.directus.io/docs/v9/app-guide/insights/insights-20220216A/metric-panel-options-20220216A.webp",alt:"Metrics Panel Options"})],-1),X=e("p",null,"Metrics Panels allow you to aggregate all Items in a Field down to a single value.",-1),J=e("ul",null,[e("li",null,[e("strong",null,"Collection"),l(" \u2013 Selects the Collection.")]),e("li",null,[e("strong",null,"Field"),l(" \u2013 Selects the Field to run aggregate function on.")]),e("li",null,[e("strong",null,"Aggregate Function"),l(" \u2013 Selects the type of aggregate to perform.")]),e("li",null,[e("strong",null,"Sort Field"),l(" \u2013 Sets the collection field you wish to order results by.")]),e("li",null,[e("strong",null,"Filter"),l(" \u2013 Sets filters to only run metrics on Items that meet some criteria.")])],-1),Q=e("h3",{id:"more-on-aggregate-functions",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#more-on-aggregate-functions"},"#"),l(" More on Aggregate Functions")],-1),Z=e("p",null,"Generally speaking, aggregate functions take a list of values and returns one single value.",-1),$=e("ul",null,[e("li",null,[e("strong",null,"Count"),l(" \u2013 Counts the number of Items in a Field.")]),e("li",null,[e("strong",null,"Count (Distinct)"),l(" \u2013 Counts the number of "),e("em",null,"unique"),l(" Items in a field.")]),e("li",null,[e("strong",null,"Average"),l(" \u2013 Averages values of all Items in a Field.")]),e("li",null,[e("strong",null,"Average (Distinct)"),l(" \u2013 Averages values of all "),e("em",null,"unique"),l(" Items in a Field.")]),e("li",null,[e("strong",null,"Sum"),l(" \u2013 Sums the values of all Items in a Field.")]),e("li",null,[e("strong",null,"Sum (Distinct)"),l(" \u2013 Sums the values of all "),e("em",null,"unique"),l(" Items in a Field.")]),e("li",null,[e("strong",null,"Minimum"),l(" \u2013 Selects the lowest valued Item in a Field.")]),e("li",null,[e("strong",null,"Maximum"),l(" \u2013 Selects the highest valued Item in a Field.")]),e("li",null,[e("strong",null,"First"),l(" \u2013 Selects the first Item out of all Items in a Field.")]),e("li",null,[e("strong",null,"Last"),l(" \u2013 Selects the last Item out of all Items in a Field.")])],-1),ee=e("div",{class:"tip hint"},[e("div",{class:"hint-title"},"First, Last, Minimum and Maximum"),e("p",null,"First, Last, Minimum and Maximum are not aggregates in the purely mathematical sense of the word. However, they are placed in this panel option because they return one single Item.")],-1),le=e("div",{class:"tip hint"},[e("div",{class:"hint-title"},"Why are some Fields grayed out?"),e("p",null,[l("Certain Fields cannot be used with certain aggregate functions. For example, you cannot use the average function on Fields that store text, because text cannot be averaged. When there is a conflict between panel options, Fields will be grayed out and unselectable in the "),e("code",null,"field dropdown list"),l(".")])],-1),te=e("h3",{id:"style-and-format-options",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#style-and-format-options"},"#"),l(" Style and Format Options")],-1),se=e("ul",null,[e("li",null,[e("strong",null,"Abbreviate Value"),l(" \u2013 Abbreviates large numbers with a letter "),e("em",null,"(e.g. 2,000 = 2K)"),l(".")]),e("li",null,[e("strong",null,"Decimals"),l(" \u2013 Changes the number of decimals displayed.")]),e("li",null,[e("strong",null,"Prefix"),l(" \u2013 Adds text before the aggregate metric.")]),e("li",null,[e("strong",null,"Suffix"),l(" \u2013 Adds text after the aggregate metric.")]),e("li",null,[e("strong",null,"Conditional Styles"),l(" \u2013 Changes color of number displayed if it is "),e("code",null,">"),l(", "),e("code",null,">="),l(", "),e("code",null,"<"),l(", "),e("code",null,"<="),l(", "),e("code",null,"=="),l(", or "),e("code",null,"!="),l(" to some defined value.")])],-1),ne=e("h2",{id:"time-series",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#time-series"},"#"),l(" Time Series")],-1),ie=e("p",null,[e("img",{src:"https://cdn.directus.io/docs/v9/app-guide/insights/insights-20220216A/time-series-panel-options-20220216A.webp",alt:"Time Series Panel Options"})],-1),ae=e("p",null,"The Time Series Panel allows you to build graphs and see how data changes over time.",-1),oe=e("ul",null,[e("li",null,[e("strong",null,"Collection"),l(" \u2013 Selects the Collection you want to analyze.")]),e("li",null,[e("strong",null,"Color"),l(" \u2013 Sets color of your graph curve.")]),e("li",null,[e("strong",null,"Group Aggregation"),l(" \u2013 Selects the type of aggregation to perform. "),e("a",{href:"#more-on-aggregate-functions"},"Learn more.")]),e("li",null,[e("strong",null,"Group Precision"),l(" \u2013 Sets the time interval to aggregate by "),e("em",null,"(days, weeks, months, etc.)"),l(".")]),e("li",null,[e("strong",null,"Date Field"),l(" \u2013 Selects the datetime Field used along the x-axis.")]),e("li",null,[e("strong",null,"Date Range"),l(" \u2013 Sets the time range from which data should be displayed, can be customized.")]),e("li",null,[e("strong",null,"Value Field"),l(" \u2013 Sets the Field you wish to aggregate.")]),e("li",null,[e("strong",null,"Value Decimals"),l(" \u2013 Changes the number of decimals displayed on the y-axis.")]),e("li",null,[e("strong",null,"Min Value"),l(" \u2013 Sets minimum value displayed on y-axis.")]),e("li",null,[e("strong",null,"Max Value"),l(" \u2013 Sets maximum value displayed on y-axis.")]),e("li",null,[e("strong",null,"Curve Type"),l(" \u2013 Sets curve to be shown as smooth, straight or stepline.")]),e("li",null,[e("strong",null,"Fill Type"),l(" \u2013 Sets fill type under curve to gradient, solid, or none.")]),e("li",null,[e("strong",null,"Filter"),l(" \u2013 Allows filtering of Items considered for analysis based on logical conditions.")]),e("li",null,[e("strong",null,"Show X-axis"),l(" \u2013 Toggles display of time along X-axis.")]),e("li",null,[e("strong",null,"Show Y-axis"),l(" \u2013 Toggles display of numeric values along Y-axis.")])],-1),re=e("div",{class:"warning hint"},[e("div",{class:"hint-title"},"Time-oriented metrics only"),e("p",null,"In order to use this Panel, your Collection will need a datetime Field.")],-1),de=e("div",{class:"tip hint"},[e("div",{class:"hint-title"},"Custom Date Range"),e("p",null,[l("Note that "),e("code",null,"Past"),l(" is not prefixed to a custom range as it is on the default ranges. When selecting "),e("strong",null,"\u201COther\u201D"),l(", simply type in "),e("code",null,"3 years"),l(", "),e("code",null,"1 month"),l(", "),e("code",null,"2 weeks"),l(", "),e("code",null,"5 days"),l(", etc.")])],-1),ue=e("h2",{id:"global-variable",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#global-variable"},"#"),l(" Global Variable")],-1),he=e("p",null,[e("img",{src:"https://cdn.directus.io/docs/v9/app-guide/insights/insights-220624A/global-variable-220624A.webp",alt:"Global Variables"})],-1),ce=e("ul",null,[e("li",null,[e("strong",null,"Variable Key"),l(" \u2014 Sets your variable. Use this key to access the variable in other Insights panels.")]),e("li",null,[e("strong",null,"Type"),l(" \u2014 Sets the data type of your variable.")]),e("li",null,[e("strong",null,"Default Value"),l(" \u2014 Sets a default value for the global variable.")]),e("li",null,[e("strong",null,"Interface"),l(" \u2014 Selects the Interface to be used.")]),e("li",null,[e("strong",null,"Options"),l(" \u2014 Sets the Interface Options.")])],-1),ge=e("p",null,"This panel allows you to create a variable which is globally accessible across other panels. You can use this to do things like create a string or number to prefix other Insights Panel titles or pass it as a value into a Filter to query results.",-1),pe=e("p",null,[l("To create and assign a Global Variable, follow the steps from "),e("a",{href:"#how-it-works"},"How it Works"),l(", selecting the Global Variable panel. Wrap the variable key in double-moustache syntax to access and assign it throughout other Insights Panels:")],-1),me=e("pre",null,[e("code",null,`{{ your_variable_key }}
+`)],-1),be=e("p",null,"You will notice that the Global Variable Panel is an interface in the Dashboard, allowing you to modify the value of this variable. If you change its value, all panels referencing the variable will update automatically.",-1),_e=e("div",{class:"warning hint"},[e("div",{class:"hint-title"},"Must be Valid Data Type"),e("p",null,"Your variable\u2019s data type will need to be a valid match to wherever you are using it. For example, do not apply a string or JSON variable in a place that requires Datetime data.")],-1),Se="Insights",xe=!1,Ae="Insights is a Module in Directus that allows rapid, no-code build-out of analytics dashboards.",De="9 min read",Fe={name:"insights",setup(fe,{expose:o}){const s={title:"Insights",modularExtension:!1,description:"Insights is a Module in Directus that allows rapid, no-code build-out of analytics dashboards.",readTime:"9 min read"};return o({frontmatter:s}),(ye,ve)=>{const n=i("router-link"),r=i("docs-wrapper");return d(),u(r,{frontmatter:s},{default:t(()=>[e("div",h,[c,g,p,m,b,_,f,y,e("p",null,[v,a(n,{to:"/docs/configuration/users-roles-permissions"},{default:t(()=>[w]),_:1}),S]),e("div",x,[A,e("p",null,[D,a(n,{to:"/docs/app/overview#_4-sidebar"},{default:t(()=>[F]),_:1}),I])]),k,C,P,T,L,M,V,O,G,H,q,N,E,R,W,Y,z,B,j,K,U,X,J,Q,Z,$,ee,le,te,se,ne,ie,ae,oe,re,de,ue,he,ce,ge,pe,me,be,_e])]),_:1})}}};export{Fe as default,Ae as description,xe as modularExtension,De as readTime,Se as title};

package/dist/assets/{installation.131e828a.js → installation.4ab6ce97.js}

@@ -1 +1 @@
-import{a,o as d,b as c,w as o,g as e,e as l,B as t}from"./runtime-core.esm-bundler.e3d5f5b7.js";const u={class:"markdown-body"},h=e("blockquote",null,[e("p",null,"Directus can be installed in many different ways and on several different stacks. You can choose between local, self-hosted on-premises, or our managed Cloud solution.")],-1),p=e("p",null,"While our CLI is the recommended method for self-hosting, you can use whichever of these self-hosted options best suits your needs. These methods offer a high level of customization and are ideal for intermediate developers.",-1),f=t("Command Line Interface (CLI)"),_=t("Docker"),m=t("Manually"),g={class:"tip hint"},y=e("div",{class:"hint-title"},"Development Environment",-1),b=t("To work on the Directus Core source code, please follow our "),k=t("Contributing Guide"),D=t("."),w=e("h2",{id:"deployment-guides",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#deployment-guides"},"#"),t(" Deployment Guides")],-1),v=e("p",null,"The following guides will walk you through the self-hosted installation process for specific third-party platforms. These options are only recommended for developers familiar with these services and comfortable with more advanced setup. While Directus is always completely free, you will likely need to pay for these services.",-1),B=t("Generic Ubuntu"),C=t("Internet Information Services (IIS)"),I=t("Amazon AWS"),T=t("Google Cloud Platform"),E=t("DigitalOcean App Platform"),S=t("Shared Hosting with Plesk"),A=e("li",null,[e("a",{href:"https://docs.cleavr.io/guides/directus",target:"_blank",rel:"noopener noreferrer"},"Cleavr.io")],-1),P=e("h2",{id:"one-click-installs",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#one-click-installs"},"#"),t(" One-Click Installs")],-1),x=e("p",null,"If you would like to completely avoid the manual installation process, the following self-hosted one-click apps will handle the heavy-lifting for you. While Directus is always completely free, you will likely need to pay for these services.",-1),L=t("Cloudron"),F=e("li",null,[e("a",{href:"https://marketplace.digitalocean.com/apps/directus?action=deploy&refcode=4c0b6062c16e",target:"_blank",rel:"noopener noreferrer"},"DigitalOcean")],-1),O=e("li",null,[e("a",{href:"https://heroku.com/deploy?template=https://github.com/directus-community/heroku-template",target:"_blank",rel:"noopener noreferrer"},"Heroku")],-1),R=e("li",null,[e("a",{href:"https://console.platform.sh/projects/create-project?template=https%3A%2F%2Fraw.githubusercontent.com%2Fplatformsh%2Ftemplate-builder%2Fmaster%2Ftemplates%2Fdirectus%2F.platform.template.yaml",target:"_blank",rel:"noopener noreferrer"},"Platform.sh")],-1),U=e("li",null,[e("a",{href:"https://deploy.zeet.co/?url=https://github.com/directus-community/heroku-template",target:"_blank",rel:"noopener noreferrer"},"Zeet")],-1),W=e("li",null,[e("a",{href:"https://app.koyeb.com/deploy?type=docker&name=directus&ports=8055;http;/&env%5BPORT%5D=8055&env%5BKEY%5D=A%20random%20string&env%5BSECRET%5D=A%20random%20string&env%5BPUBLIC_URL%5D=https://myURL.com/&env%5BDB_CLIENT%5D=DB%20client&env%5BDB_HOST%5D=DB%20host&env%5BDB_PORT%5D=DB%20Port&env%5BDB_DATABASE%5D=Database%20name&env%5BDB_USER%5D=DB%20user&env%5BDB_PASSWORD%5D=DB%20Password&image=directus/directus",target:"_blank",rel:"noopener noreferrer"},"Koyeb")],-1),G=e("li",null,[e("a",{href:"https://www.alwaysdata.com/en/marketplace/directus",target:"_blank",rel:"noopener noreferrer"},"alwaysdata")],-1),N=e("li",null,[e("a",{href:"https://elest.io/open-source/directus",target:"_blank",rel:"noopener noreferrer"},"Elestio")],-1),Y=e("h2",{id:"directus-cloud",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#directus-cloud"},"#"),t(" Directus Cloud")],-1),j=e("p",null,"In addition to the self-hosted options above, you can also choose to create Directus projects using our official Managed Cloud Service. This is the easiest way to get up-and-running with Directus \u2014 even for non-technical users. Unique features include dedicated hardware, automatic updates, automatic backups, usage-based pricing, and more.",-1),z=e("ul",null,[e("li",null,[e("a",{href:"http://directus.cloud",target:"_blank",rel:"noopener noreferrer"},"Directus Cloud Dashboard")]),e("li",null,[e("a",{href:"https://directus.io/on-demand-cloud",target:"_blank",rel:"noopener noreferrer"},"Learn more about On-Demand Cloud")]),e("li",null,[e("a",{href:"https://directus.io/enterprise-cloud",target:"_blank",rel:"noopener noreferrer"},"Learn more about Enterprise Cloud")])],-1),M="Installation",Z=!1,J="Directus can be installed in many different ways and on several different stacks. You can choose between local, self-hosted on-premises, or our managed Cloud solution.",Q="2 min read",X={name:"installation",setup(H,{expose:r}){const n={title:"Installation",modularExtension:!1,description:"Directus can be installed in many different ways and on several different stacks. You can choose between local, self-hosted on-premises, or our managed Cloud solution.",readTime:"2 min read"};return r({frontmatter:n}),(V,q)=>{const s=a("router-link"),i=a("docs-wrapper");return d(),c(i,{frontmatter:n},{default:o(()=>[e("div",u,[h,p,e("ul",null,[e("li",null,[l(s,{to:"/docs/self-hosted/installation/cli"},{default:o(()=>[f]),_:1})]),e("li",null,[l(s,{to:"/docs/self-hosted/installation/docker"},{default:o(()=>[_]),_:1})]),e("li",null,[l(s,{to:"/docs/self-hosted/installation/manual"},{default:o(()=>[m]),_:1})])]),e("div",g,[y,e("p",null,[b,l(s,{to:"/docs/contributing/introduction"},{default:o(()=>[k]),_:1}),D])]),w,v,e("ul",null,[e("li",null,[l(s,{to:"/docs/self-hosted/installation/ubuntu"},{default:o(()=>[B]),_:1})]),e("li",null,[l(s,{to:"/docs/self-hosted/installation/iis"},{default:o(()=>[C]),_:1})]),e("li",null,[l(s,{to:"/docs/self-hosted/installation/aws"},{default:o(()=>[I]),_:1})]),e("li",null,[l(s,{to:"/docs/self-hosted/installation/gcp"},{default:o(()=>[T]),_:1})]),e("li",null,[l(s,{to:"/docs/self-hosted/installation/digitalocean-app-platform"},{default:o(()=>[E]),_:1})]),e("li",null,[l(s,{to:"/docs/self-hosted/installation/plesk"},{default:o(()=>[S]),_:1})]),A]),P,x,e("ul",null,[e("li",null,[l(s,{to:"/docs/self-hosted/installation/cloudron"},{default:o(()=>[L]),_:1})]),F,O,R,U,W,G,N]),Y,j,z])]),_:1})}}};export{X as default,J as description,Z as modularExtension,Q as readTime,M as title};
+import{a,o as d,b as c,w as o,l as e,e as l,E as t}from"./runtime-core.esm-bundler.32cac88a.js";const u={class:"markdown-body"},h=e("blockquote",null,[e("p",null,"Directus can be installed in many different ways and on several different stacks. You can choose between local, self-hosted on-premises, or our managed Cloud solution.")],-1),p=e("p",null,"While our CLI is the recommended method for self-hosting, you can use whichever of these self-hosted options best suits your needs. These methods offer a high level of customization and are ideal for intermediate developers.",-1),f=t("Command Line Interface (CLI)"),_=t("Docker"),m=t("Manually"),g={class:"tip hint"},y=e("div",{class:"hint-title"},"Development Environment",-1),b=t("To work on the Directus Core source code, please follow our "),k=t("Contributing Guide"),D=t("."),w=e("h2",{id:"deployment-guides",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#deployment-guides"},"#"),t(" Deployment Guides")],-1),v=e("p",null,"The following guides will walk you through the self-hosted installation process for specific third-party platforms. These options are only recommended for developers familiar with these services and comfortable with more advanced setup. While Directus is always completely free, you will likely need to pay for these services.",-1),B=t("Generic Ubuntu"),C=t("Internet Information Services (IIS)"),I=t("Amazon AWS"),T=t("Google Cloud Platform"),E=t("DigitalOcean App Platform"),S=t("Shared Hosting with Plesk"),A=e("li",null,[e("a",{href:"https://docs.cleavr.io/guides/directus",target:"_blank",rel:"noopener noreferrer"},"Cleavr.io")],-1),P=e("h2",{id:"one-click-installs",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#one-click-installs"},"#"),t(" One-Click Installs")],-1),x=e("p",null,"If you would like to completely avoid the manual installation process, the following self-hosted one-click apps will handle the heavy-lifting for you. While Directus is always completely free, you will likely need to pay for these services.",-1),L=t("Cloudron"),F=e("li",null,[e("a",{href:"https://marketplace.digitalocean.com/apps/directus?action=deploy&refcode=4c0b6062c16e",target:"_blank",rel:"noopener noreferrer"},"DigitalOcean")],-1),O=e("li",null,[e("a",{href:"https://heroku.com/deploy?template=https://github.com/directus-community/heroku-template",target:"_blank",rel:"noopener noreferrer"},"Heroku")],-1),R=e("li",null,[e("a",{href:"https://console.platform.sh/projects/create-project?template=https%3A%2F%2Fraw.githubusercontent.com%2Fplatformsh%2Ftemplate-builder%2Fmaster%2Ftemplates%2Fdirectus%2F.platform.template.yaml",target:"_blank",rel:"noopener noreferrer"},"Platform.sh")],-1),U=e("li",null,[e("a",{href:"https://deploy.zeet.co/?url=https://github.com/directus-community/heroku-template",target:"_blank",rel:"noopener noreferrer"},"Zeet")],-1),W=e("li",null,[e("a",{href:"https://app.koyeb.com/deploy?type=docker&name=directus&ports=8055;http;/&env%5BPORT%5D=8055&env%5BKEY%5D=A%20random%20string&env%5BSECRET%5D=A%20random%20string&env%5BPUBLIC_URL%5D=https://myURL.com/&env%5BDB_CLIENT%5D=DB%20client&env%5BDB_HOST%5D=DB%20host&env%5BDB_PORT%5D=DB%20Port&env%5BDB_DATABASE%5D=Database%20name&env%5BDB_USER%5D=DB%20user&env%5BDB_PASSWORD%5D=DB%20Password&image=directus/directus",target:"_blank",rel:"noopener noreferrer"},"Koyeb")],-1),G=e("li",null,[e("a",{href:"https://www.alwaysdata.com/en/marketplace/directus",target:"_blank",rel:"noopener noreferrer"},"alwaysdata")],-1),N=e("li",null,[e("a",{href:"https://elest.io/open-source/directus",target:"_blank",rel:"noopener noreferrer"},"Elestio")],-1),Y=e("h2",{id:"directus-cloud",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#directus-cloud"},"#"),t(" Directus Cloud")],-1),j=e("p",null,"In addition to the self-hosted options above, you can also choose to create Directus projects using our official Managed Cloud Service. This is the easiest way to get up-and-running with Directus \u2014 even for non-technical users. Unique features include dedicated hardware, automatic updates, automatic backups, usage-based pricing, and more.",-1),z=e("ul",null,[e("li",null,[e("a",{href:"http://directus.cloud",target:"_blank",rel:"noopener noreferrer"},"Directus Cloud Dashboard")]),e("li",null,[e("a",{href:"https://directus.io/on-demand-cloud",target:"_blank",rel:"noopener noreferrer"},"Learn more about On-Demand Cloud")]),e("li",null,[e("a",{href:"https://directus.io/enterprise-cloud",target:"_blank",rel:"noopener noreferrer"},"Learn more about Enterprise Cloud")])],-1),M="Installation",Z=!1,J="Directus can be installed in many different ways and on several different stacks. You can choose between local, self-hosted on-premises, or our managed Cloud solution.",Q="2 min read",X={name:"installation",setup(H,{expose:r}){const n={title:"Installation",modularExtension:!1,description:"Directus can be installed in many different ways and on several different stacks. You can choose between local, self-hosted on-premises, or our managed Cloud solution.",readTime:"2 min read"};return r({frontmatter:n}),(V,q)=>{const s=a("router-link"),i=a("docs-wrapper");return d(),c(i,{frontmatter:n},{default:o(()=>[e("div",u,[h,p,e("ul",null,[e("li",null,[l(s,{to:"/docs/self-hosted/installation/cli"},{default:o(()=>[f]),_:1})]),e("li",null,[l(s,{to:"/docs/self-hosted/installation/docker"},{default:o(()=>[_]),_:1})]),e("li",null,[l(s,{to:"/docs/self-hosted/installation/manual"},{default:o(()=>[m]),_:1})])]),e("div",g,[y,e("p",null,[b,l(s,{to:"/docs/contributing/introduction"},{default:o(()=>[k]),_:1}),D])]),w,v,e("ul",null,[e("li",null,[l(s,{to:"/docs/self-hosted/installation/ubuntu"},{default:o(()=>[B]),_:1})]),e("li",null,[l(s,{to:"/docs/self-hosted/installation/iis"},{default:o(()=>[C]),_:1})]),e("li",null,[l(s,{to:"/docs/self-hosted/installation/aws"},{default:o(()=>[I]),_:1})]),e("li",null,[l(s,{to:"/docs/self-hosted/installation/gcp"},{default:o(()=>[T]),_:1})]),e("li",null,[l(s,{to:"/docs/self-hosted/installation/digitalocean-app-platform"},{default:o(()=>[E]),_:1})]),e("li",null,[l(s,{to:"/docs/self-hosted/installation/plesk"},{default:o(()=>[S]),_:1})]),A]),P,x,e("ul",null,[e("li",null,[l(s,{to:"/docs/self-hosted/installation/cloudron"},{default:o(()=>[L]),_:1})]),F,O,R,U,W,G,N]),Y,j,z])]),_:1})}}};export{X as default,J as description,Z as modularExtension,Q as readTime,M as title};

package/dist/assets/{interface.aa4f61a0.js → interface.1195a442.js}

@@ -1 +1 @@
-import{a as n,o as s,b as r,w as c,g as t}from"./runtime-core.esm-bundler.e3d5f5b7.js";const i=t("div",{class:"markdown-body"},[t("p",null,"This pane includes any customization options that may be defined by the Interface.")],-1),m="Interface",_=!1,u={name:"interface",setup(l,{expose:o}){const e={title:"Interface",modularExtension:!1};return o({frontmatter:e}),(p,d)=>{const a=n("docs-wrapper");return s(),r(a,{frontmatter:e},{default:c(()=>[i]),_:1})}}};export{u as default,_ as modularExtension,m as title};
+import{a as n,o as s,b as r,w as c,l as t}from"./runtime-core.esm-bundler.32cac88a.js";const i=t("div",{class:"markdown-body"},[t("p",null,"This pane includes any customization options that may be defined by the Interface.")],-1),m="Interface",_=!1,u={name:"interface",setup(l,{expose:o}){const e={title:"Interface",modularExtension:!1};return o({frontmatter:e}),(p,d)=>{const a=n("docs-wrapper");return s(),r(a,{frontmatter:e},{default:c(()=>[i]),_:1})}}};export{u as default,_ as modularExtension,m as title};

package/dist/assets/{interfaces.fc4c7384.js → interfaces.0dddec2f.js}

@@ -1,4 +1,4 @@
-import{a,o as r,b as d,w as n,g as e,e as o,B as t}from"./runtime-core.esm-bundler.e3d5f5b7.js";const u={class:"markdown-body"},h=t("Custom Interfaces allow you to create new ways of viewing or interacting with field data on the Item Detail page. "),p=t("Learn more about Interfaces"),f=t("."),_=e("h2",{id:"extension-entrypoint",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#extension-entrypoint"},"#"),t(" Extension Entrypoint")],-1),m=e("p",null,[t("The entrypoint of your interface is the "),e("code",null,"index"),t(" file inside the "),e("code",null,"src/"),t(" folder of your extension package. It exports a configuration object with options to configure the behavior of your interface. When loading your interface, this object is imported by the Directus host.")],-1),y=e("p",null,"Example of an entrypoint:",-1),g=e("pre",null,[e("code",{class:"language-js"},[e("span",{class:"hljs-keyword"},"import"),t(),e("span",{class:"hljs-title class_"},"InterfaceComponent"),t(),e("span",{class:"hljs-keyword"},"from"),t(),e("span",{class:"hljs-string"},"'./interface.vue'"),t(`;
+import{a,o as r,b as d,w as n,l as e,e as o,E as t}from"./runtime-core.esm-bundler.32cac88a.js";const u={class:"markdown-body"},h=t("Custom Interfaces allow you to create new ways of viewing or interacting with field data on the Item Detail page. "),p=t("Learn more about Interfaces"),f=t("."),_=e("h2",{id:"extension-entrypoint",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#extension-entrypoint"},"#"),t(" Extension Entrypoint")],-1),m=e("p",null,[t("The entrypoint of your interface is the "),e("code",null,"index"),t(" file inside the "),e("code",null,"src/"),t(" folder of your extension package. It exports a configuration object with options to configure the behavior of your interface. When loading your interface, this object is imported by the Directus host.")],-1),y=e("p",null,"Example of an entrypoint:",-1),g=e("pre",null,[e("code",{class:"language-js"},[e("span",{class:"hljs-keyword"},"import"),t(),e("span",{class:"hljs-title class_"},"InterfaceComponent"),t(),e("span",{class:"hljs-keyword"},"from"),t(),e("span",{class:"hljs-string"},"'./interface.vue'"),t(`;
 
 `),e("span",{class:"hljs-keyword"},"export"),t(),e("span",{class:"hljs-keyword"},"default"),t(` {
 	`),e("span",{class:"hljs-attr"},"id"),t(": "),e("span",{class:"hljs-string"},"'custom'"),t(`,

package/dist/assets/{introduction.b1da78a4.js → introduction.201b3a46.js}

@@ -1,4 +1,4 @@
-import{a as n,o as l,b as c,w as o,g as e,e as i,B as t}from"./runtime-core.esm-bundler.e3d5f5b7.js";const d={class:"markdown-body"},h=e("blockquote",null,[e("p",null,[t("Our team truly appreciates every single contributor, community member, GitHub star, pull-request, bug report, and feature request. Keeping Directus completely free and open-source is our way of saying: "),e("strong",null,"Thank you!")])],-1),p=e("div",{class:"tip hint"},[e("div",{class:"hint-title"},"We're here to help!"),e("p",null,[t("If you have "),e("em",null,"any"),t(" questions along your contributor journey, please feel free to come chat with us on our "),e("a",{href:"https://directus.chat",target:"_blank",rel:"noopener noreferrer"},"Discord Community"),t(".")])],-1),f=e("div",{class:"tip hint"},[e("div",{class:"hint-title"},"Technical Contributor Docs"),e("p",null,[t("Technical documentation for contributing to the core codebase is located on the main "),e("code",null,"directus/directus"),e("a",{href:"https://github.com/directus/directus/wiki",target:"_blank",rel:"noopener noreferrer"},"GitHub repository\u2019s Wiki"),t(".")])],-1),_=e("h2",{id:"code-of-conduct",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#code-of-conduct"},"#"),t(" Code of Conduct")],-1),g=e("p",null,[e("strong",null,[t("The Directus "),e("a",{href:"https://github.com/directus/directus/blob/main/code_of_conduct.md",target:"_blank",rel:"noopener noreferrer"},"Code of Conduct"),t(" is one of the ways we put our values into practice. We expect all of our staff, contractors and contributors to know and follow this code.")])],-1),b=e("p",null,[e("strong",null,"Our contributors and maintainers work extremely hard to build Directus as premium open-source software. Please be respectful of those efforts throughout our ecosystem. Trolling, harassing, insulting, or other unacceptable behavior by participants will not be tolerated.")],-1),m=e("p",null,"In the interest of fostering an open and welcoming environment, we as pledge to make participation in our project and community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.",-1),y=e("p",null,"Examples of behavior that contributes to creating a positive environment include:",-1),w=e("ul",null,[e("li",null,"Using welcoming and inclusive language"),e("li",null,"Being respectful of differing viewpoints and experiences"),e("li",null,"Gracefully accepting constructive criticism"),e("li",null,"Focusing on what is best for the community"),e("li",null,"Showing empathy towards other community members")],-1),v=e("p",null,[e("strong",null,[t("Before continuing, please take a moment to read our full "),e("a",{href:"https://github.com/directus/directus/blob/main/contributing.md",target:"_blank",rel:"noopener noreferrer"},"Code of Conduct"),t(".")])],-1),k=e("h2",{id:"wait-%E2%80%94-before-you-begin",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#wait-%E2%80%94-before-you-begin"},"#"),t(" Wait \u2014 Before you Begin")],-1),x=t("When contributing to this repository, it is important to first discuss the change you wish to make with the owners of this repository. This can be done via "),q=e("a",{href:"https://github.com/directus/directus/issues",target:"_blank",rel:"noopener noreferrer"},"GitHub Issue",-1),D=t(", "),C=e("a",{href:"https://github.com/directus/directus/discussions",target:"_blank",rel:"noopener noreferrer"},"GitHub Discussions",-1),R=t(", "),T=e("a",{href:"https://directus.chat",target:"_blank",rel:"noopener noreferrer"},"Discord",-1),F=t(", "),B=t("email"),Y=t(", or any other method."),A=e("p",null,"Following this rule will help avoid wasted time caused by multiple people working on the same issue or writing code that will not be merged.",-1),G=e("h2",{id:"feature-requests",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#feature-requests"},"#"),t(" Feature Requests")],-1),H=e("p",null,[t("Feature requests are a great way to let our team know what should be prioritized next. You can "),e("a",{href:"https://github.com/directus/directus/discussions/new",target:"_blank",rel:"noopener noreferrer"},"submit a new feature request"),t(" or "),e("a",{href:"https://github.com/directus/directus/discussions",target:"_blank",rel:"noopener noreferrer"},"vote on existing submissions"),t(" via GitHub Discussions.")],-1),S=e("div",{class:"warning hint"},[e("div",{class:"hint-title"},"The 80/20 Rule"),e("p",null,"To keep the Directus codebase as clean and simple as possible, we will only consider approving features that we feel at least 80% of our user-base will find valuable. If your feature request falls within the 20% range, it is considered an edge-case and should be implemented as an extension.")],-1),W=e("h2",{id:"rfcs",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#rfcs"},"#"),t(" RFCs")],-1),I=e("p",null,[t("Some Directus features/fixes may require additional design, strategy, and/or discussion before beginning work. For these notable pull-requests, you should first submit an RFC (Request For Comments) to our core team via "),e("a",{href:"https://directus.chat",target:"_blank",rel:"noopener noreferrer"},"Discord"),t(". This process is relatively informal, but ensures proper alignment, and helps avoid squandered development time by contributors.")],-1),E=e("h2",{id:"bug-reporting",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#bug-reporting"},"#"),t(" Bug Reporting")],-1),N=e("p",null,[t("Reporting any bugs you come across is an invaluable part of helping keep Directus stable. After confirming a similar issue doesn\u2019t already exist, you can "),e("a",{href:"https://github.com/directus/directus/issues/new",target:"_blank",rel:"noopener noreferrer"},"submit a bug report"),t(" via GitHub Issues. Please ensure the following for all submissions:")],-1),O=e("li",null,"You are experiencing an actual bug, not a configuration issue",-1),P=e("li",null,"You are using the official (pre-built) version of directus and not a fork",-1),V=e("li",null,"You are not asking a question or requesting a new feature",-1),U=e("li",null,"You have checked that no similar issue (or discussion) already exists",-1),j=e("li",null,"You have entered a clear and concise title",-1),z=e("li",null,"You have followed the issue template, with stack details and steps to reproduce",-1),K=t("You have already completed all "),L=t("troubleshooting steps"),M=e("h2",{id:"reporting-security-vulnerabilities",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#reporting-security-vulnerabilities"},"#"),t(" Reporting Security Vulnerabilities")],-1),J=t("If you believe you have discovered a security issue within a Directus product or service, please reach out to us directly over email: "),Q=t("security@directus.io"),X=t(". We will then open a "),Z=e("a",{href:"https://github.com/directus/directus/security/advisories",target:"_blank",rel:"noopener noreferrer"},"GitHub Security Advisory",-1),$=t(" for tracking the fix."),ee=e("p",null,"We value the members of the independent security research community who find security vulnerabilities and work with our team so that proper fixes can be issued to users. Our policy is to credit all researchers in the fix\u2019s release notes. In order to receive credit, security researchers must follow responsible disclosure practices, including:",-1),te=e("ul",null,[e("li",null,"They do not publish the vulnerability prior to the Directus team releasing a fix for it"),e("li",null,"They do not divulge exact details of the issue, e.g., through exploits or proof-of-concepts")],-1),oe=e("h2",{id:"submitting-a-pull-request",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#submitting-a-pull-request"},"#"),t(" Submitting a Pull-Request")],-1),se=e("h3",{id:"1.-submit-an-rfc-(if-needed)",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#1.-submit-an-rfc-(if-needed)"},"#"),t(" 1. Submit an RFC (if needed)")],-1),ie=e("p",null,[t("Please read our docs on the "),e("a",{href:"#rfcs"},"RFC process"),t(".")],-1),re=e("h3",{id:"2.-update-relevant-docs",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#2.-update-relevant-docs"},"#"),t(" 2. Update relevant docs")],-1),ne=e("p",null,"Before submitting any pull-requests, ensure that any relevant documentation (included in this same repo) is updated.",-1),ae=e("h3",{id:"3.-push-your-changes",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#3.-push-your-changes"},"#"),t(" 3. Push your changes")],-1),ue=e("pre",null,[e("code",{class:"language-bash"},`git push -u origin YOUR-BRANCH-NAME
+import{a as n,o as l,b as c,w as o,l as e,e as i,E as t}from"./runtime-core.esm-bundler.32cac88a.js";const d={class:"markdown-body"},h=e("blockquote",null,[e("p",null,[t("Our team truly appreciates every single contributor, community member, GitHub star, pull-request, bug report, and feature request. Keeping Directus completely free and open-source is our way of saying: "),e("strong",null,"Thank you!")])],-1),p=e("div",{class:"tip hint"},[e("div",{class:"hint-title"},"We're here to help!"),e("p",null,[t("If you have "),e("em",null,"any"),t(" questions along your contributor journey, please feel free to come chat with us on our "),e("a",{href:"https://directus.chat",target:"_blank",rel:"noopener noreferrer"},"Discord Community"),t(".")])],-1),f=e("div",{class:"tip hint"},[e("div",{class:"hint-title"},"Technical Contributor Docs"),e("p",null,[t("Technical documentation for contributing to the core codebase is located on the main "),e("code",null,"directus/directus"),e("a",{href:"https://github.com/directus/directus/wiki",target:"_blank",rel:"noopener noreferrer"},"GitHub repository\u2019s Wiki"),t(".")])],-1),_=e("h2",{id:"code-of-conduct",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#code-of-conduct"},"#"),t(" Code of Conduct")],-1),g=e("p",null,[e("strong",null,[t("The Directus "),e("a",{href:"https://github.com/directus/directus/blob/main/code_of_conduct.md",target:"_blank",rel:"noopener noreferrer"},"Code of Conduct"),t(" is one of the ways we put our values into practice. We expect all of our staff, contractors and contributors to know and follow this code.")])],-1),b=e("p",null,[e("strong",null,"Our contributors and maintainers work extremely hard to build Directus as premium open-source software. Please be respectful of those efforts throughout our ecosystem. Trolling, harassing, insulting, or other unacceptable behavior by participants will not be tolerated.")],-1),m=e("p",null,"In the interest of fostering an open and welcoming environment, we as pledge to make participation in our project and community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.",-1),y=e("p",null,"Examples of behavior that contributes to creating a positive environment include:",-1),w=e("ul",null,[e("li",null,"Using welcoming and inclusive language"),e("li",null,"Being respectful of differing viewpoints and experiences"),e("li",null,"Gracefully accepting constructive criticism"),e("li",null,"Focusing on what is best for the community"),e("li",null,"Showing empathy towards other community members")],-1),v=e("p",null,[e("strong",null,[t("Before continuing, please take a moment to read our full "),e("a",{href:"https://github.com/directus/directus/blob/main/contributing.md",target:"_blank",rel:"noopener noreferrer"},"Code of Conduct"),t(".")])],-1),k=e("h2",{id:"wait-%E2%80%94-before-you-begin",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#wait-%E2%80%94-before-you-begin"},"#"),t(" Wait \u2014 Before you Begin")],-1),x=t("When contributing to this repository, it is important to first discuss the change you wish to make with the owners of this repository. This can be done via "),q=e("a",{href:"https://github.com/directus/directus/issues",target:"_blank",rel:"noopener noreferrer"},"GitHub Issue",-1),D=t(", "),C=e("a",{href:"https://github.com/directus/directus/discussions",target:"_blank",rel:"noopener noreferrer"},"GitHub Discussions",-1),R=t(", "),T=e("a",{href:"https://directus.chat",target:"_blank",rel:"noopener noreferrer"},"Discord",-1),F=t(", "),B=t("email"),Y=t(", or any other method."),A=e("p",null,"Following this rule will help avoid wasted time caused by multiple people working on the same issue or writing code that will not be merged.",-1),G=e("h2",{id:"feature-requests",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#feature-requests"},"#"),t(" Feature Requests")],-1),H=e("p",null,[t("Feature requests are a great way to let our team know what should be prioritized next. You can "),e("a",{href:"https://github.com/directus/directus/discussions/new",target:"_blank",rel:"noopener noreferrer"},"submit a new feature request"),t(" or "),e("a",{href:"https://github.com/directus/directus/discussions",target:"_blank",rel:"noopener noreferrer"},"vote on existing submissions"),t(" via GitHub Discussions.")],-1),S=e("div",{class:"warning hint"},[e("div",{class:"hint-title"},"The 80/20 Rule"),e("p",null,"To keep the Directus codebase as clean and simple as possible, we will only consider approving features that we feel at least 80% of our user-base will find valuable. If your feature request falls within the 20% range, it is considered an edge-case and should be implemented as an extension.")],-1),W=e("h2",{id:"rfcs",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#rfcs"},"#"),t(" RFCs")],-1),E=e("p",null,[t("Some Directus features/fixes may require additional design, strategy, and/or discussion before beginning work. For these notable pull-requests, you should first submit an RFC (Request For Comments) to our core team via "),e("a",{href:"https://directus.chat",target:"_blank",rel:"noopener noreferrer"},"Discord"),t(". This process is relatively informal, but ensures proper alignment, and helps avoid squandered development time by contributors.")],-1),I=e("h2",{id:"bug-reporting",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#bug-reporting"},"#"),t(" Bug Reporting")],-1),N=e("p",null,[t("Reporting any bugs you come across is an invaluable part of helping keep Directus stable. After confirming a similar issue doesn\u2019t already exist, you can "),e("a",{href:"https://github.com/directus/directus/issues/new",target:"_blank",rel:"noopener noreferrer"},"submit a bug report"),t(" via GitHub Issues. Please ensure the following for all submissions:")],-1),O=e("li",null,"You are experiencing an actual bug, not a configuration issue",-1),P=e("li",null,"You are using the official (pre-built) version of directus and not a fork",-1),V=e("li",null,"You are not asking a question or requesting a new feature",-1),U=e("li",null,"You have checked that no similar issue (or discussion) already exists",-1),j=e("li",null,"You have entered a clear and concise title",-1),z=e("li",null,"You have followed the issue template, with stack details and steps to reproduce",-1),K=t("You have already completed all "),L=t("troubleshooting steps"),M=e("h2",{id:"reporting-security-vulnerabilities",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#reporting-security-vulnerabilities"},"#"),t(" Reporting Security Vulnerabilities")],-1),J=t("If you believe you have discovered a security issue within a Directus product or service, please reach out to us directly over email: "),Q=t("security@directus.io"),X=t(". We will then open a "),Z=e("a",{href:"https://github.com/directus/directus/security/advisories",target:"_blank",rel:"noopener noreferrer"},"GitHub Security Advisory",-1),$=t(" for tracking the fix."),ee=e("p",null,"We value the members of the independent security research community who find security vulnerabilities and work with our team so that proper fixes can be issued to users. Our policy is to credit all researchers in the fix\u2019s release notes. In order to receive credit, security researchers must follow responsible disclosure practices, including:",-1),te=e("ul",null,[e("li",null,"They do not publish the vulnerability prior to the Directus team releasing a fix for it"),e("li",null,"They do not divulge exact details of the issue, e.g., through exploits or proof-of-concepts")],-1),oe=e("h2",{id:"submitting-a-pull-request",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#submitting-a-pull-request"},"#"),t(" Submitting a Pull-Request")],-1),se=e("h3",{id:"1.-submit-an-rfc-(if-needed)",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#1.-submit-an-rfc-(if-needed)"},"#"),t(" 1. Submit an RFC (if needed)")],-1),ie=e("p",null,[t("Please read our docs on the "),e("a",{href:"#rfcs"},"RFC process"),t(".")],-1),re=e("h3",{id:"2.-update-relevant-docs",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#2.-update-relevant-docs"},"#"),t(" 2. Update relevant docs")],-1),ne=e("p",null,"Before submitting any pull-requests, ensure that any relevant documentation (included in this same repo) is updated.",-1),ae=e("h3",{id:"3.-push-your-changes",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#3.-push-your-changes"},"#"),t(" 3. Push your changes")],-1),ue=e("pre",null,[e("code",{class:"language-bash"},`git push -u origin YOUR-BRANCH-NAME
 `)],-1),le=e("h3",{id:"submit-a-pull-request",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#submit-a-pull-request"},"#"),t(" Submit a pull-request")],-1),ce=e("p",null,"Once you push the changes to your repo, the \u201CCompare & pull request\u201D button will appear in GitHub. Click it and you\u2019ll be taken to a screen where you can fill in the appropriate details. Finally, open the pull request by clicking the \u201CCreate pull request\u201D button.",-1),de=e("p",null,"Now our core staff will review your contribution and either merge it, or request that you to make changes.",-1),he=e("h2",{id:"syncing-your-fork-with-directus",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#syncing-your-fork-with-directus"},"#"),t(" Syncing Your Fork with Directus")],-1),pe=e("p",null,"After you have submitted your pull requests, you would need to sync your fork with Directus to pull all the latest commits before you continue to contribute.",-1),fe=e("h3",{id:"1.-add-directus-as-a-remote",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#1.-add-directus-as-a-remote"},"#"),t(" 1. Add Directus as a Remote")],-1),_e=e("p",null,"While your fork is your main remote or origin, you will add Directus as the upstream, which generally refers to the original repo that you have forked.",-1),ge=e("pre",null,[e("code",{class:"language-bash"},`git remote add upstream git@github.com:directus/directus.git
 `)],-1),be=e("h3",{id:"2.-fetch-the-latest-changes",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#2.-fetch-the-latest-changes"},"#"),t(" 2. Fetch the Latest Changes")],-1),me=e("p",null,[t("Depending on your setup, you will need to get the latest commits from the "),e("code",null,"main"),t(" branch of Directus by doing a pull, reset, rebase or fetch.")],-1),ye=e("pre",null,[e("code",{class:"language-bash"},`git pull upstream main
-`)],-1),we=e("p",null,"At this point you are ready to continue working on Directus, with the latest commits included!",-1),ve=e("div",{class:"tip hint"},[e("p",null,"Before you begin or resume development, be sure to always sync, if you are going to submit a pull request with your changes!")],-1),Ce="Contributing",Re=!1,Te="An introduction to the process, rules and guidelines that for all code contributions to Directus.",Fe="6 min read",Be={name:"introduction",setup(ke,{expose:a}){const r={title:"Contributing",modularExtension:!1,description:"An introduction to the process, rules and guidelines that for all code contributions to Directus.",readTime:"6 min read"};return a({frontmatter:r}),(xe,qe)=>{const s=n("router-link"),u=n("docs-wrapper");return l(),c(u,{frontmatter:r},{default:o(()=>[e("div",d,[h,p,f,_,g,b,m,y,w,v,k,e("p",null,[x,q,D,C,R,T,F,i(s,{to:"/docsmailto:info@directus.io"},{default:o(()=>[B]),_:1}),Y]),A,G,H,S,W,I,E,N,e("ul",null,[O,P,V,U,j,z,e("li",null,[K,i(s,{to:"/docs/getting-started/support#troubleshooting-steps"},{default:o(()=>[L]),_:1})])]),M,e("p",null,[J,i(s,{to:"/docsmailto:security@directus.io"},{default:o(()=>[Q]),_:1}),X,Z,$]),ee,te,oe,se,ie,re,ne,ae,ue,le,ce,de,he,pe,fe,_e,ge,be,me,ye,we,ve])]),_:1})}}};export{Be as default,Te as description,Re as modularExtension,Fe as readTime,Ce as title};
+`)],-1),we=e("p",null,"At this point you are ready to continue working on Directus, with the latest commits included!",-1),ve=e("div",{class:"tip hint"},[e("p",null,"Before you begin or resume development, be sure to always sync, if you are going to submit a pull request with your changes!")],-1),Ce="Contributing",Re=!1,Te="An introduction to the process, rules and guidelines that for all code contributions to Directus.",Fe="6 min read",Be={name:"introduction",setup(ke,{expose:a}){const r={title:"Contributing",modularExtension:!1,description:"An introduction to the process, rules and guidelines that for all code contributions to Directus.",readTime:"6 min read"};return a({frontmatter:r}),(xe,qe)=>{const s=n("router-link"),u=n("docs-wrapper");return l(),c(u,{frontmatter:r},{default:o(()=>[e("div",d,[h,p,f,_,g,b,m,y,w,v,k,e("p",null,[x,q,D,C,R,T,F,i(s,{to:"/docsmailto:info@directus.io"},{default:o(()=>[B]),_:1}),Y]),A,G,H,S,W,E,I,N,e("ul",null,[O,P,V,U,j,z,e("li",null,[K,i(s,{to:"/docs/getting-started/support#troubleshooting-steps"},{default:o(()=>[L]),_:1})])]),M,e("p",null,[J,i(s,{to:"/docsmailto:security@directus.io"},{default:o(()=>[Q]),_:1}),X,Z,$]),ee,te,oe,se,ie,re,ne,ae,ue,le,ce,de,he,pe,fe,_e,ge,be,me,ye,we,ve])]),_:1})}}};export{Be as default,Te as description,Re as modularExtension,Fe as readTime,Ce as title};

package/dist/assets/{introduction.0f06a30b.js → introduction.2a49238f.js}

@@ -1 +1 @@
-import{a as d,o as c,b as r,w as s,g as e,e as n,B as t}from"./runtime-core.esm-bundler.e3d5f5b7.js";const _={class:"markdown-body"},h=e("blockquote",null,[e("p",null,"In addition to being highly customizable, Directus has been architected to be completely modular and extensible. This ensures you will never hit a hard feature ceiling within the platform.")],-1),u=e("p",null,"Build, modify or expand any feature needed for your app or project. What makes Directus so flexible is that it has been designed from the ground up with complete extensibility. In addition to offering our software\u2019s codebase as open-source, we\u2019ve broken down the app code into component pieces called Extensions. New Extensions can be created, modified or expanded to suit any need. However, the following extension types come with the platform\u2019s App and API.",-1),p=e("h2",{id:"extension-sdk",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#extension-sdk"},"#"),t(" Extension SDK")],-1),x=t("The easiest way to start creating extensions is to use the "),m=t("Extensions SDK"),f=t("."),w=e("h2",{id:"app-extensions",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#app-extensions"},"#"),t(" App Extensions")],-1),b=e("p",null,"Allow creating custom experiences within the Directus App.",-1),y=t("Modules"),g=t(" \u2014 Created with Vue.js"),E=t("Layouts"),C=t(" \u2014 Created with Vue.js"),j=t("Interfaces"),k=t(" \u2014 Created with Vue.js"),A=t("Displays"),v=t(" \u2014 Created with Vue.js"),V=t("Panels"),D=t(" \u2014 Created with Vue.js"),N=t("Themes"),S=t(" \u2014 Created with custom CSS"),T=e("h2",{id:"api-extensions",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#api-extensions"},"#"),t(" API Extensions")],-1),I=e("p",null,"Allow extending and customizing the data pipeline and platform logic.",-1),B=t("Endpoints"),J=t(" \u2014 Created with JavaScript / Node.js"),P=t("Hooks"),H=t(" \u2014 Created with JavaScript / Node.js"),q=t("Email Templates"),z=t(" \u2014 Created with Liquid.js"),K=t("Migrations"),L=t(" \u2014 Created with JavaScript / Node.js"),M=e("h2",{id:"hybrid-extensions",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#hybrid-extensions"},"#"),t(" Hybrid Extensions")],-1),O=e("p",null,"Allow adding functionality to the API as well as the App.",-1),W=t("Operations"),F=t(" \u2014 Created with Vue.js and JavaScript / Node.js"),X="Extensions",Y=!1,Z="An introduction to custom Extensions in Directus.",$="2 min read",ee={name:"introduction",setup(G,{expose:a}){const i={title:"Extensions",modularExtension:!1,description:"An introduction to custom Extensions in Directus.",readTime:"2 min read"};return a({frontmatter:i}),(Q,R)=>{const o=d("router-link"),l=d("docs-wrapper");return c(),r(l,{frontmatter:i},{default:s(()=>[e("div",_,[h,u,p,e("p",null,[x,n(o,{to:"/docs/extensions/creating-extensions"},{default:s(()=>[m]),_:1}),f]),w,b,e("ul",null,[e("li",null,[n(o,{to:"/docs/extensions/modules"},{default:s(()=>[y]),_:1}),g]),e("li",null,[n(o,{to:"/docs/extensions/layouts"},{default:s(()=>[E]),_:1}),C]),e("li",null,[n(o,{to:"/docs/extensions/interfaces"},{default:s(()=>[j]),_:1}),k]),e("li",null,[n(o,{to:"/docs/extensions/displays"},{default:s(()=>[A]),_:1}),v]),e("li",null,[n(o,{to:"/docs/extensions/panels"},{default:s(()=>[V]),_:1}),D]),e("li",null,[n(o,{to:"/docs/extensions/themes"},{default:s(()=>[N]),_:1}),S])]),T,I,e("ul",null,[e("li",null,[n(o,{to:"/docs/extensions/endpoints"},{default:s(()=>[B]),_:1}),J]),e("li",null,[n(o,{to:"/docs/extensions/hooks"},{default:s(()=>[P]),_:1}),H]),e("li",null,[n(o,{to:"/docs/extensions/email-templates"},{default:s(()=>[q]),_:1}),z]),e("li",null,[n(o,{to:"/docs/extensions/migrations"},{default:s(()=>[K]),_:1}),L])]),M,O,e("ul",null,[e("li",null,[n(o,{to:"/docs/extensions/operations"},{default:s(()=>[W]),_:1}),F])])])]),_:1})}}};export{ee as default,Z as description,Y as modularExtension,$ as readTime,X as title};
+import{a as d,o as c,b as r,w as s,l as e,e as n,E as t}from"./runtime-core.esm-bundler.32cac88a.js";const _={class:"markdown-body"},h=e("blockquote",null,[e("p",null,"In addition to being highly customizable, Directus has been architected to be completely modular and extensible. This ensures you will never hit a hard feature ceiling within the platform.")],-1),u=e("p",null,"Build, modify or expand any feature needed for your app or project. What makes Directus so flexible is that it has been designed from the ground up with complete extensibility. In addition to offering our software\u2019s codebase as open-source, we\u2019ve broken down the app code into component pieces called Extensions. New Extensions can be created, modified or expanded to suit any need. However, the following extension types come with the platform\u2019s App and API.",-1),p=e("h2",{id:"extension-sdk",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#extension-sdk"},"#"),t(" Extension SDK")],-1),x=t("The easiest way to start creating extensions is to use the "),m=t("Extensions SDK"),f=t("."),w=e("h2",{id:"app-extensions",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#app-extensions"},"#"),t(" App Extensions")],-1),b=e("p",null,"Allow creating custom experiences within the Directus App.",-1),y=t("Modules"),g=t(" \u2014 Created with Vue.js"),E=t("Layouts"),C=t(" \u2014 Created with Vue.js"),j=t("Interfaces"),k=t(" \u2014 Created with Vue.js"),A=t("Displays"),v=t(" \u2014 Created with Vue.js"),V=t("Panels"),D=t(" \u2014 Created with Vue.js"),N=t("Themes"),S=t(" \u2014 Created with custom CSS"),T=e("h2",{id:"api-extensions",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#api-extensions"},"#"),t(" API Extensions")],-1),I=e("p",null,"Allow extending and customizing the data pipeline and platform logic.",-1),B=t("Endpoints"),J=t(" \u2014 Created with JavaScript / Node.js"),P=t("Hooks"),H=t(" \u2014 Created with JavaScript / Node.js"),q=t("Email Templates"),z=t(" \u2014 Created with Liquid.js"),K=t("Migrations"),L=t(" \u2014 Created with JavaScript / Node.js"),M=e("h2",{id:"hybrid-extensions",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#hybrid-extensions"},"#"),t(" Hybrid Extensions")],-1),O=e("p",null,"Allow adding functionality to the API as well as the App.",-1),W=t("Operations"),F=t(" \u2014 Created with Vue.js and JavaScript / Node.js"),X="Extensions",Y=!1,Z="An introduction to custom Extensions in Directus.",$="2 min read",ee={name:"introduction",setup(G,{expose:a}){const i={title:"Extensions",modularExtension:!1,description:"An introduction to custom Extensions in Directus.",readTime:"2 min read"};return a({frontmatter:i}),(Q,R)=>{const o=d("router-link"),l=d("docs-wrapper");return c(),r(l,{frontmatter:i},{default:s(()=>[e("div",_,[h,u,p,e("p",null,[x,n(o,{to:"/docs/extensions/creating-extensions"},{default:s(()=>[m]),_:1}),f]),w,b,e("ul",null,[e("li",null,[n(o,{to:"/docs/extensions/modules"},{default:s(()=>[y]),_:1}),g]),e("li",null,[n(o,{to:"/docs/extensions/layouts"},{default:s(()=>[E]),_:1}),C]),e("li",null,[n(o,{to:"/docs/extensions/interfaces"},{default:s(()=>[j]),_:1}),k]),e("li",null,[n(o,{to:"/docs/extensions/displays"},{default:s(()=>[A]),_:1}),v]),e("li",null,[n(o,{to:"/docs/extensions/panels"},{default:s(()=>[V]),_:1}),D]),e("li",null,[n(o,{to:"/docs/extensions/themes"},{default:s(()=>[N]),_:1}),S])]),T,I,e("ul",null,[e("li",null,[n(o,{to:"/docs/extensions/endpoints"},{default:s(()=>[B]),_:1}),J]),e("li",null,[n(o,{to:"/docs/extensions/hooks"},{default:s(()=>[P]),_:1}),H]),e("li",null,[n(o,{to:"/docs/extensions/email-templates"},{default:s(()=>[q]),_:1}),z]),e("li",null,[n(o,{to:"/docs/extensions/migrations"},{default:s(()=>[K]),_:1}),L])]),M,O,e("ul",null,[e("li",null,[n(o,{to:"/docs/extensions/operations"},{default:s(()=>[W]),_:1}),F])])])]),_:1})}}};export{ee as default,Z as description,Y as modularExtension,$ as readTime,X as title};

package/dist/assets/{introduction.24acabd2.js → introduction.569a3b41.js}

@@ -1,4 +1,4 @@
-import{a as o,o as r,b as u,w as n,g as t,e as a,B as s}from"./runtime-core.esm-bundler.e3d5f5b7.js";const h={class:"markdown-body"},d=t("blockquote",null,[t("p",null,"Directus offers both a RESTful and GraphQL API to manage the data in the database. The API has predictable resource-oriented URLs, relies on standard HTTP status codes, and uses JSON for input and output.")],-1),p=t("h2",{id:"dynamic-api",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#dynamic-api"},"#"),s(" Dynamic API")],-1),_=s("The platform\u2019s API uses "),f=s("Database Mirroring"),m=s(" to dynamically generate REST endpoints and a GraphQL schema based on the connected database\u2019s architecture. Since these endpoints return data based on your specific schema and configured permissions, the input/output of the API differs greatly for individual installations."),j=t("h2",{id:"rest-vs.-graphql",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#rest-vs.-graphql"},"#"),s(" REST vs. GraphQL")],-1),y=t("p",null,[t("strong",null,"There is no difference in the functionality available between the REST and GraphQL endpoints."),s(" The functionality available in both is mapped to the same set of core services, meaning that you don\u2019t lose any performance or capabilities by choosing one or the other.")],-1),g=t("p",null,"Which one you choose is ultimately up to you.",-1),b=t("h2",{id:"authentication",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#authentication"},"#"),s(" Authentication")],-1),w=s("By default, all data in the system is off-limits for unauthenticated users. To gain access to protected data, you must "),T=s("include an access token with every request"),E=s(", or "),v=s("configure permissions for the public role"),A=s("."),k=t("p",null,"Useful references:",-1),I=s("Authenticating into the API"),P=s("Login endpoint reference"),x=t("h2",{id:"relational-data",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#relational-data"},"#"),s(" Relational Data")],-1),D=s("Directus only retrieves the fields in your items that explicitly have been requested. Relational data can be retrieved nested by using "),S=s("the "),R=t("code",null,"fields",-1),q=s(" parameter"),L=s(" in REST, or regular nested queries in GraphQL. This allows you to retrieve the author of your article included in the articles data, or fetch related log entry points for your app\u2019s analytics data for example."),N=t("h3",{id:"creating-%2F-updating-%2F-deleting",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#creating-%2F-updating-%2F-deleting"},"#"),s(" Creating / Updating / Deleting")],-1),O=t("p",null,"Similarly to fetching, relational content can be modified deeply as well.",-1),C=t("h4",{id:"many-to-one",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#many-to-one"},"#"),s(" Many-to-One")],-1),H=t("p",null,"Many-to-One relationships are fairly straightforward to manage relationally. You can simply submit the changes you want as an object under the relational key in your collection. For example, if you wanted to create a new featured article on your page, you could submit:",-1),U=t("pre",null,[t("code",{class:"language-json"},[t("span",{class:"hljs-punctuation"},"{"),s(`
+import{a as o,o as r,b as u,w as n,l as t,e as a,E as s}from"./runtime-core.esm-bundler.32cac88a.js";const h={class:"markdown-body"},d=t("blockquote",null,[t("p",null,"Directus offers both a RESTful and GraphQL API to manage the data in the database. The API has predictable resource-oriented URLs, relies on standard HTTP status codes, and uses JSON for input and output.")],-1),p=t("h2",{id:"dynamic-api",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#dynamic-api"},"#"),s(" Dynamic API")],-1),_=s("The platform\u2019s API uses "),f=s("Database Mirroring"),m=s(" to dynamically generate REST endpoints and a GraphQL schema based on the connected database\u2019s architecture. Since these endpoints return data based on your specific schema and configured permissions, the input/output of the API differs greatly for individual installations."),j=t("h2",{id:"rest-vs.-graphql",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#rest-vs.-graphql"},"#"),s(" REST vs. GraphQL")],-1),y=t("p",null,[t("strong",null,"There is no difference in the functionality available between the REST and GraphQL endpoints."),s(" The functionality available in both is mapped to the same set of core services, meaning that you don\u2019t lose any performance or capabilities by choosing one or the other.")],-1),g=t("p",null,"Which one you choose is ultimately up to you.",-1),b=t("h2",{id:"authentication",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#authentication"},"#"),s(" Authentication")],-1),w=s("By default, all data in the system is off-limits for unauthenticated users. To gain access to protected data, you must "),T=s("include an access token with every request"),E=s(", or "),v=s("configure permissions for the public role"),A=s("."),k=t("p",null,"Useful references:",-1),I=s("Authenticating into the API"),P=s("Login endpoint reference"),x=t("h2",{id:"relational-data",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#relational-data"},"#"),s(" Relational Data")],-1),D=s("Directus only retrieves the fields in your items that explicitly have been requested. Relational data can be retrieved nested by using "),S=s("the "),R=t("code",null,"fields",-1),q=s(" parameter"),L=s(" in REST, or regular nested queries in GraphQL. This allows you to retrieve the author of your article included in the articles data, or fetch related log entry points for your app\u2019s analytics data for example."),N=t("h3",{id:"creating-%2F-updating-%2F-deleting",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#creating-%2F-updating-%2F-deleting"},"#"),s(" Creating / Updating / Deleting")],-1),O=t("p",null,"Similarly to fetching, relational content can be modified deeply as well.",-1),C=t("h4",{id:"many-to-one",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#many-to-one"},"#"),s(" Many-to-One")],-1),H=t("p",null,"Many-to-One relationships are fairly straightforward to manage relationally. You can simply submit the changes you want as an object under the relational key in your collection. For example, if you wanted to create a new featured article on your page, you could submit:",-1),U=t("pre",null,[t("code",{class:"language-json"},[t("span",{class:"hljs-punctuation"},"{"),s(`
 	`),t("span",{class:"hljs-attr"},'"featured_article"'),t("span",{class:"hljs-punctuation"},":"),s(),t("span",{class:"hljs-punctuation"},"{"),s(`
 		`),t("span",{class:"hljs-attr"},'"title"'),t("span",{class:"hljs-punctuation"},":"),s(),t("span",{class:"hljs-string"},'"This is my new article!"'),s(`
 	`),t("span",{class:"hljs-punctuation"},"}"),s(`
@@ -9,10 +9,10 @@ import{a as o,o as r,b as u,w as n,g as t,e as a,B as s}from"./runtime-core.esm-
 		`),t("span",{class:"hljs-attr"},'"title"'),t("span",{class:"hljs-punctuation"},":"),s(),t("span",{class:"hljs-string"},'"This is an updated title for my article!"'),s(`
 	`),t("span",{class:"hljs-punctuation"},"}"),s(`
 `),t("span",{class:"hljs-punctuation"},"}"),s(`
-`)])],-1),V=t("p",null,"Seeing that the Many-to-One relationship stores the foreign key on the field itself, removing the item can be done by nullifying the field:",-1),B=t("pre",null,[t("code",{class:"language-json"},[t("span",{class:"hljs-punctuation"},"{"),s(`
+`)])],-1),V=t("p",null,"Seeing that the Many-to-One relationship stores the foreign key on the field itself, removing the item can be done by nullifying the field:",-1),F=t("pre",null,[t("code",{class:"language-json"},[t("span",{class:"hljs-punctuation"},"{"),s(`
 	`),t("span",{class:"hljs-attr"},'"featured_article"'),t("span",{class:"hljs-punctuation"},":"),s(),t("span",{class:"hljs-literal"},[t("span",{class:"hljs-keyword"},"null")]),s(`
 `),t("span",{class:"hljs-punctuation"},"}"),s(`
-`)])],-1),F=t("h4",{id:"one-to-many-(%2F-many-to-many)",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#one-to-many-(%2F-many-to-many)"},"#"),s(" One-to-Many (/ Many-to-Many)")],-1),Q=t("p",null,"One-to-Many, and therefore Many-to-Many and Many-to-Any, relationships can be updated in one of two ways:",-1),Y=t("p",null,[t("strong",null,"Basic")],-1),W=t("p",null,[s("The API will return one-to-many fields as an array of nested keys or items (based on the "),t("code",null,"fields"),s(" parameter). You can use this same structure to select what the related items are:")],-1),K=t("pre",null,[t("code",{class:"language-json"},[t("span",{class:"hljs-punctuation"},"{"),s(`
+`)])],-1),Q=t("h4",{id:"one-to-many-(%2F-many-to-many)",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#one-to-many-(%2F-many-to-many)"},"#"),s(" One-to-Many (/ Many-to-Many)")],-1),B=t("p",null,"One-to-Many, and therefore Many-to-Many and Many-to-Any, relationships can be updated in one of two ways:",-1),Y=t("p",null,[t("strong",null,"Basic")],-1),W=t("p",null,[s("The API will return one-to-many fields as an array of nested keys or items (based on the "),t("code",null,"fields"),s(" parameter). You can use this same structure to select what the related items are:")],-1),K=t("pre",null,[t("code",{class:"language-json"},[t("span",{class:"hljs-punctuation"},"{"),s(`
 	`),t("span",{class:"hljs-attr"},'"children"'),t("span",{class:"hljs-punctuation"},":"),s(),t("span",{class:"hljs-punctuation"},"["),t("span",{class:"hljs-number"},"2"),t("span",{class:"hljs-punctuation"},","),s(),t("span",{class:"hljs-number"},"7"),t("span",{class:"hljs-punctuation"},","),s(),t("span",{class:"hljs-number"},"149"),t("span",{class:"hljs-punctuation"},"]"),s(`
 `),t("span",{class:"hljs-punctuation"},"}"),s(`
 `)])],-1),X=t("p",null,"You can also provide an object instead of a primary key in order to create new items nested on the fly, or an object with a primary key included to update an existing item:",-1),z=t("pre",null,[t("code",{class:"language-json"},[t("span",{class:"hljs-punctuation"},"{"),s(`
@@ -87,4 +87,4 @@ import{a as o,o as r,b as u,w as n,g as t,e as a,B as s}from"./runtime-core.esm-
 		`),t("span",{class:"hljs-punctuation"},"}"),s(`
 	`),t("span",{class:"hljs-punctuation"},"}"),s(`
 `),t("span",{class:"hljs-punctuation"},"}"),s(`
-`)])],-1),bt=t("p",null,[s("There\u2019s a lot of discussion around whether or not to put a body in a GET request, to use POSTs to create search queries, or to rely on a different method altogether. As of right now, we\u2019ve chosen "),t("a",{href:"https://datatracker.ietf.org/doc/draft-ietf-httpbis-safe-method-w-body",target:"_blank",rel:"noopener noreferrer"},[s("to align with IETF\u2019s "),t("em",null,"HTTP SEARCH Method"),s(" specification")]),s(". While we recognize this is still a draft spec, the SEARCH method has been used extensively before in the WebDAV world ("),t("a",{href:"https://tools.ietf.org/html/rfc5323",target:"_blank",rel:"noopener noreferrer"},"spec"),s("), and compared to the other available options, it feels like the \u201Ccleanest\u201D and most correct to handle this moving forward. As with everything else, if you have any ideas, opinions, or concerns, "),t("a",{href:"https://github.com/directus/directus/discussions/new",target:"_blank",rel:"noopener noreferrer"},"we\u2019d love to hear your thoughts"),s(".")],-1),wt=t("p",null,"Useful reading:",-1),Tt=t("ul",null,[t("li",null,[t("a",{href:"https://datatracker.ietf.org/doc/draft-ietf-httpbis-safe-method-w-body",target:"_blank",rel:"noopener noreferrer"},[t("em",null,"HTTP SEARCH Method"),s(" (IETF, 2021)")])]),t("li",null,[t("a",{href:"https://httptoolkit.tech/blog/http-search-method",target:"_blank",rel:"noopener noreferrer"},[t("em",null,"Defining a new HTTP method: HTTP SEARCH"),s(" (Tim Perry, 2021)")])]),t("li",null,[t("a",{href:"https://stackoverflow.com/questions/978061/http-get-with-request-body",target:"_blank",rel:"noopener noreferrer"},[t("em",null,"HTTP GET with request body"),s(" (StackOverflow, 2009 and ongoing)")])]),t("li",null,[t("a",{href:"https://www.elastic.co/guide/en/elasticsearch/guide/current/_empty_search.html",target:"_blank",rel:"noopener noreferrer"},[t("em",null,"Elastic Search GET body usage"),s(" (elastic, n.d.)")])]),t("li",null,[t("a",{href:"https://evertpot.com/dropbox-post-api",target:"_blank",rel:"noopener noreferrer"},[t("em",null,"Dropbox starts using POST, and why this is poor API design."),s(" (Evert Pot, 2015)")])])],-1),Et=t("h2",{id:"system-data-in-graphql",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#system-data-in-graphql"},"#"),s(" System data in GraphQL")],-1),vt=t("p",null,[s("Due to restrictions in GraphQL itself, it\u2019s impossible to properly scope/namespace system functionality from regular data access. In order to prevent any naming conflicts between user-created and system data, we\u2019ve scoped the access of the two into separate endpoints for user and system data respectively: "),t("code",null,"/graphql"),s(" and "),t("code",null,"/graphql/system"),s(". Both endpoints share the same underlying schema, so "),t("strong",null,"nested relations will work as expected"),s(" regardless if they \u201Ccross over\u201D between user and system data. The only difference in the two endpoints are the root query and mutation fields available.")],-1),At=t("h2",{id:"error-codes",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#error-codes"},"#"),s(" Error Codes")],-1),kt=t("p",null,"Below are the global error codes used within Directus, and what they mean.",-1),It=t("table",null,[t("thead",null,[t("tr",null,[t("th",null,"Error Code"),t("th",null,"HTTP Status"),t("th",null,"Description")])]),t("tbody",null,[t("tr",null,[t("td",null,[t("code",null,"FAILED_VALIDATION")]),t("td",null,"400"),t("td",null,"Validation for this particular item failed")]),t("tr",null,[t("td",null,[t("code",null,"FORBIDDEN")]),t("td",null,"403"),t("td",null,"You are not allowed to do the current action")]),t("tr",null,[t("td",null,[t("code",null,"INVALID_TOKEN")]),t("td",null,"403"),t("td",null,"Provided token is invalid")]),t("tr",null,[t("td",null,[t("code",null,"TOKEN_EXPIRED")]),t("td",null,"401"),t("td",null,"Provided token is valid but has expired")]),t("tr",null,[t("td",null,[t("code",null,"INVALID_CREDENTIALS")]),t("td",null,"401"),t("td",null,"Username / password or access token is wrong")]),t("tr",null,[t("td",null,[t("code",null,"INVALID_IP")]),t("td",null,"401"),t("td",null,"Your IP address isn\u2019t allow-listed to be used with this user")]),t("tr",null,[t("td",null,[t("code",null,"INVALID_OTP")]),t("td",null,"401"),t("td",null,"Wrong OTP was provided")]),t("tr",null,[t("td",null,[t("code",null,"INVALID_PAYLOAD")]),t("td",null,"400"),t("td",null,"Provided payload is invalid")]),t("tr",null,[t("td",null,[t("code",null,"INVALID_QUERY")]),t("td",null,"400"),t("td",null,"The requested query parameters can not be used")]),t("tr",null,[t("td",null,[t("code",null,"UNSUPPORTED_MEDIA_TYPE")]),t("td",null,"415"),t("td",null,[s("Provided payload format or "),t("code",null,"Content-Type"),s(" header is unsupported")])]),t("tr",null,[t("td",null,[t("code",null,"REQUESTS_EXCEEDED")]),t("td",null,"429"),t("td",null,"Hit the rate limit")]),t("tr",null,[t("td",null,[t("code",null,"ROUTE_NOT_FOUND")]),t("td",null,"404"),t("td",null,"Endpoint does not exist")]),t("tr",null,[t("td",null,[t("code",null,"SERVICE_UNAVAILABLE")]),t("td",null,"503"),t("td",null,"Could not use external service")]),t("tr",null,[t("td",null,[t("code",null,"UNPROCESSABLE_ENTITY")]),t("td",null,"422"),t("td",null,"You tried doing something illegal")])])],-1),Pt=t("div",{class:"warning hint"},[t("div",{class:"hint-title"},"Security"),t("p",null,[s("To prevent leaking which items exist, all actions for non-existing items will return a "),t("code",null,"FORBIDDEN"),s(" error.")])],-1),qt="API Reference",Lt=!1,Nt="An introduction to the REST and GraphQL APIs in Directus.",Ot="7 min read",Ct="page-reference",Ht={name:"introduction",setup(xt,{expose:i}){const l={title:"API Reference",modularExtension:!1,description:"An introduction to the REST and GraphQL APIs in Directus.",readTime:"7 min read",pageClass:"page-reference"};return i({frontmatter:l}),(Dt,St)=>{const e=o("router-link"),c=o("docs-wrapper");return r(),u(c,{frontmatter:l},{default:n(()=>[t("div",h,[d,p,t("p",null,[_,a(e,{to:"/docs/getting-started/introduction#database-mirroring"},{default:n(()=>[f]),_:1}),m]),j,y,g,b,t("p",null,[w,a(e,{to:"/docs/reference/authentication#access-tokens"},{default:n(()=>[T]),_:1}),E,a(e,{to:"/docs/getting-started/quickstart#_6-set-role-public-permissions"},{default:n(()=>[v]),_:1}),A]),k,t("ul",null,[t("li",null,[a(e,{to:"/docs/reference/authentication"},{default:n(()=>[I]),_:1})]),t("li",null,[a(e,{to:"/docs/reference/authentication#login"},{default:n(()=>[P]),_:1})])]),x,t("p",null,[D,a(e,{to:"/docs/reference/query#fields"},{default:n(()=>[S,R,q]),_:1}),L]),N,O,C,H,U,G,M,V,B,F,Q,Y,W,K,X,z,J,Z,$,tt,st,nt,et,at,lt,ot,it,ct,rt,ut,ht,dt,pt,_t,ft,mt,jt,yt,gt,bt,wt,Tt,Et,vt,At,kt,It,Pt])]),_:1})}}};export{Ht as default,Nt as description,Lt as modularExtension,Ct as pageClass,Ot as readTime,qt as title};
+`)])],-1),bt=t("p",null,[s("There\u2019s a lot of discussion around whether or not to put a body in a GET request, to use POSTs to create search queries, or to rely on a different method altogether. As of right now, we\u2019ve chosen "),t("a",{href:"https://datatracker.ietf.org/doc/draft-ietf-httpbis-safe-method-w-body",target:"_blank",rel:"noopener noreferrer"},[s("to align with IETF\u2019s "),t("em",null,"HTTP SEARCH Method"),s(" specification")]),s(". While we recognize this is still a draft spec, the SEARCH method has been used extensively before in the WebDAV world ("),t("a",{href:"https://tools.ietf.org/html/rfc5323",target:"_blank",rel:"noopener noreferrer"},"spec"),s("), and compared to the other available options, it feels like the \u201Ccleanest\u201D and most correct to handle this moving forward. As with everything else, if you have any ideas, opinions, or concerns, "),t("a",{href:"https://github.com/directus/directus/discussions/new",target:"_blank",rel:"noopener noreferrer"},"we\u2019d love to hear your thoughts"),s(".")],-1),wt=t("p",null,"Useful reading:",-1),Tt=t("ul",null,[t("li",null,[t("a",{href:"https://datatracker.ietf.org/doc/draft-ietf-httpbis-safe-method-w-body",target:"_blank",rel:"noopener noreferrer"},[t("em",null,"HTTP SEARCH Method"),s(" (IETF, 2021)")])]),t("li",null,[t("a",{href:"https://httptoolkit.tech/blog/http-search-method",target:"_blank",rel:"noopener noreferrer"},[t("em",null,"Defining a new HTTP method: HTTP SEARCH"),s(" (Tim Perry, 2021)")])]),t("li",null,[t("a",{href:"https://stackoverflow.com/questions/978061/http-get-with-request-body",target:"_blank",rel:"noopener noreferrer"},[t("em",null,"HTTP GET with request body"),s(" (StackOverflow, 2009 and ongoing)")])]),t("li",null,[t("a",{href:"https://www.elastic.co/guide/en/elasticsearch/guide/current/_empty_search.html",target:"_blank",rel:"noopener noreferrer"},[t("em",null,"Elastic Search GET body usage"),s(" (elastic, n.d.)")])]),t("li",null,[t("a",{href:"https://evertpot.com/dropbox-post-api",target:"_blank",rel:"noopener noreferrer"},[t("em",null,"Dropbox starts using POST, and why this is poor API design."),s(" (Evert Pot, 2015)")])])],-1),Et=t("h2",{id:"system-data-in-graphql",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#system-data-in-graphql"},"#"),s(" System data in GraphQL")],-1),vt=t("p",null,[s("Due to restrictions in GraphQL itself, it\u2019s impossible to properly scope/namespace system functionality from regular data access. In order to prevent any naming conflicts between user-created and system data, we\u2019ve scoped the access of the two into separate endpoints for user and system data respectively: "),t("code",null,"/graphql"),s(" and "),t("code",null,"/graphql/system"),s(". Both endpoints share the same underlying schema, so "),t("strong",null,"nested relations will work as expected"),s(" regardless if they \u201Ccross over\u201D between user and system data. The only difference in the two endpoints are the root query and mutation fields available.")],-1),At=t("h2",{id:"error-codes",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#error-codes"},"#"),s(" Error Codes")],-1),kt=t("p",null,"Below are the global error codes used within Directus, and what they mean.",-1),It=t("table",null,[t("thead",null,[t("tr",null,[t("th",null,"Error Code"),t("th",null,"HTTP Status"),t("th",null,"Description")])]),t("tbody",null,[t("tr",null,[t("td",null,[t("code",null,"FAILED_VALIDATION")]),t("td",null,"400"),t("td",null,"Validation for this particular item failed")]),t("tr",null,[t("td",null,[t("code",null,"FORBIDDEN")]),t("td",null,"403"),t("td",null,"You are not allowed to do the current action")]),t("tr",null,[t("td",null,[t("code",null,"INVALID_TOKEN")]),t("td",null,"403"),t("td",null,"Provided token is invalid")]),t("tr",null,[t("td",null,[t("code",null,"TOKEN_EXPIRED")]),t("td",null,"401"),t("td",null,"Provided token is valid but has expired")]),t("tr",null,[t("td",null,[t("code",null,"INVALID_CREDENTIALS")]),t("td",null,"401"),t("td",null,"Username / password or access token is wrong")]),t("tr",null,[t("td",null,[t("code",null,"INVALID_IP")]),t("td",null,"401"),t("td",null,"Your IP address isn\u2019t allow-listed to be used with this user")]),t("tr",null,[t("td",null,[t("code",null,"INVALID_OTP")]),t("td",null,"401"),t("td",null,"Wrong OTP was provided")]),t("tr",null,[t("td",null,[t("code",null,"INVALID_PAYLOAD")]),t("td",null,"400"),t("td",null,"Provided payload is invalid")]),t("tr",null,[t("td",null,[t("code",null,"INVALID_QUERY")]),t("td",null,"400"),t("td",null,"The requested query parameters can not be used")]),t("tr",null,[t("td",null,[t("code",null,"UNSUPPORTED_MEDIA_TYPE")]),t("td",null,"415"),t("td",null,[s("Provided payload format or "),t("code",null,"Content-Type"),s(" header is unsupported")])]),t("tr",null,[t("td",null,[t("code",null,"REQUESTS_EXCEEDED")]),t("td",null,"429"),t("td",null,"Hit the rate limit")]),t("tr",null,[t("td",null,[t("code",null,"ROUTE_NOT_FOUND")]),t("td",null,"404"),t("td",null,"Endpoint does not exist")]),t("tr",null,[t("td",null,[t("code",null,"SERVICE_UNAVAILABLE")]),t("td",null,"503"),t("td",null,"Could not use external service")]),t("tr",null,[t("td",null,[t("code",null,"UNPROCESSABLE_ENTITY")]),t("td",null,"422"),t("td",null,"You tried doing something illegal")])])],-1),Pt=t("div",{class:"warning hint"},[t("div",{class:"hint-title"},"Security"),t("p",null,[s("To prevent leaking which items exist, all actions for non-existing items will return a "),t("code",null,"FORBIDDEN"),s(" error.")])],-1),qt="API Reference",Lt=!1,Nt="An introduction to the REST and GraphQL APIs in Directus.",Ot="7 min read",Ct="page-reference",Ht={name:"introduction",setup(xt,{expose:i}){const l={title:"API Reference",modularExtension:!1,description:"An introduction to the REST and GraphQL APIs in Directus.",readTime:"7 min read",pageClass:"page-reference"};return i({frontmatter:l}),(Dt,St)=>{const e=o("router-link"),c=o("docs-wrapper");return r(),u(c,{frontmatter:l},{default:n(()=>[t("div",h,[d,p,t("p",null,[_,a(e,{to:"/docs/getting-started/introduction#database-mirroring"},{default:n(()=>[f]),_:1}),m]),j,y,g,b,t("p",null,[w,a(e,{to:"/docs/reference/authentication#access-tokens"},{default:n(()=>[T]),_:1}),E,a(e,{to:"/docs/getting-started/quickstart#_6-set-role-public-permissions"},{default:n(()=>[v]),_:1}),A]),k,t("ul",null,[t("li",null,[a(e,{to:"/docs/reference/authentication"},{default:n(()=>[I]),_:1})]),t("li",null,[a(e,{to:"/docs/reference/authentication#login"},{default:n(()=>[P]),_:1})])]),x,t("p",null,[D,a(e,{to:"/docs/reference/query#fields"},{default:n(()=>[S,R,q]),_:1}),L]),N,O,C,H,U,G,M,V,F,Q,B,Y,W,K,X,z,J,Z,$,tt,st,nt,et,at,lt,ot,it,ct,rt,ut,ht,dt,pt,_t,ft,mt,jt,yt,gt,bt,wt,Tt,Et,vt,At,kt,It,Pt])]),_:1})}}};export{Ht as default,Nt as description,Lt as modularExtension,Ct as pageClass,Ot as readTime,qt as title};

package/dist/assets/{introduction.e8ce5583.js → introduction.daef5dfe.js}

@@ -1 +1 @@
-import{a as i,o as d,b as c,w as o,g as e,e as a,B as t}from"./runtime-core.esm-bundler.e3d5f5b7.js";const u={class:"markdown-body"},h=e("blockquote",null,[e("p",null,"These Docs will help you get Directus up-and-running quickly, guide you through advanced features, and explain the core concepts that make Directus so unique.")],-1),p=e("h2",{id:"what-is-directus%3F",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#what-is-directus%3F"},"#"),t(" What is Directus?")],-1),m=e("div",{class:"tip hint"},[e("div",{class:"hint-title"},"Directus"),e("p",null,[t("Directus ("),e("a",{href:"http://audio.pronouncekiwi.com/Salli/Directus",target:"_blank",rel:"noopener noreferrer"},"duh REKT iss"),t(") is Latin for: "),e("em",null,"laid straight, arranged in lines"),t("."),e("br"),t(" The broadest goal of our platform is to present data in a simple, orderly, and intuitive way.")])],-1),_=e("p",null,[e("strong",null,"Directus is an Open Data Platform built to democratize the database."),e("br"),t(" This platform provides everyone on your team, "),e("em",null,"regardless of technical skill"),t(", equal access to data and digital file asset management, for any data model or project. First, link Directus to your desired SQL database and file storage adapter. After that, Directus enables you to perform CRUD operations, create users, assign roles with fully configurable permissions, build complex and granular queries, configure event-driven webhooks and task automation\u2026 "),e("em",null,"the list goes on!")],-1),g=e("p",null,[e("strong",null,"Database Introspection & Abstraction"),e("br"),t(" SQL flavors all come with slightly different data types and idiosyncrasies. Directus uses "),e("a",{href:"#how-it-works"},"Database Introspection"),t(" to read your database structure and create an abstraction layer to handle all the nitty-gritty details behind the scenes. This technique works seamlessly with any major SQL database. It also lets you link Directus to your new or pre-existing database or remove it anytime, with no impact on your existing data model. That means you\u2019ll never encounter vendor lock-in.")],-1),f=e("p",null,[e("strong",null,"The App and APIs"),e("br"),t(" Once your database is introspected and abstracted, Directus dynamically generates REST and GraphQL API endpoints to manage your data with granular control. You also get CLI tools for file management and a complete JavaScript SDK.")],-1),y=e("p",null,[t("The API and CLI power the no-code App. In other words, the App is just a GUI that provides no-code access to the API. This architecture is how Directus democratizes the database and provides control to "),e("a",{href:"#who-s-it-for"},"the whole team"),t(".")],-1),b=e("p",null,[e("strong",null,"Open-Source, Modular, Extensible, Scalable"),e("br"),t(" At the highest level, Directus organizes its features and functionality into Modules. Each Module allows you to interact with data in some specific way, such as data and content management, digital file asset management, drag and drop analytics dashboard creation, or whatever. If you find Directus is missing something that your project needs, no problem!")],-1),w=e("p",null,[t("Built entirely in Typescript, primarily on "),e("a",{href:"https://nodejs.dev",target:"_blank",rel:"noopener noreferrer"},"Node.js"),t(" and "),e("a",{href:"https://vuejs.org",target:"_blank",rel:"noopener noreferrer"},"Vue.js"),t(", Directus is 100% open-source, modular and extensible, ensuring your project never hits a hard feature ceiling. The platform scales without issue, "),e("em",null,"and some Projects have hundreds of millions of users.")],-1),v=e("p",null,[t("You can use it with any "),e("em",null,"(or many)"),t(" stacks or frontend frameworks.")],-1),D=e("p",null,[e("strong",null,"Custom Configuration Options"),e("br"),t(" Extensive configuration options are also available as global variables in the codebase. Developers can custom configure SSO authentication method, caching details, default file storage location (local, S3, google, etc.) for digital assets, emails, "),e("em",null,"and much more.")],-1),k={class:"tip hint"},x=e("div",{class:"hint-title"},"Ready to dive in?",-1),T=t("Get a free project running in minutes. Learn Directus hands-on in the "),I=t("Quickstart Guide"),C=t("."),S=e("h2",{id:"how-it-works",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#how-it-works"},"#"),t(" How It Works")],-1),A=e("p",null,[e("strong",null,[t("Directus is installed as a "),e("em",null,"layer"),t(" on top of your new or existing SQL database.")])],-1),j=e("p",null,[t("The App and API dynamically "),e("em",null,"\u201Cmirror\u201D"),t(" your actual schema and content in real-time. This is similar to how technical database clients (like "),e("em",null,"phpMyAdmin"),t(") work. However, Database Introspection has many unique advantages:")],-1),P=e("ul",null,[e("li",null,"Absolute control over your pure SQL database schema."),e("li",null,"Complete transparency, portability, and security for your data."),e("li",null,"Allows importing existing databases, unaltered and without migrations."),e("li",null,"Direct database access and the full power of raw, complex SQL queries."),e("li",null,"Significant performance improvements through optimizations and indexing.")],-1),E=e("p",null,[t("In contrast, other platforms typically use a predefined or proprietary "),e("em",null,"one-size-fits-all"),t(" data model to store content . That is not the case with Directus. Directus gives you direct access to your pure and unaltered data. That means you have the option to bypass the Directus middleware (API, SDK, App) and connect to your data with proper SQL queries. This effectively removes all bottlenecks, latency overhead, and proprietary access limitations.")],-1),L=e("h2",{id:"who%E2%80%99s-it-for%3F",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#who%E2%80%99s-it-for%3F"},"#"),t(" Who\u2019s It For?")],-1),q=e("p",null,[e("strong",null,"Directus lets the whole team work together and access data in one place.")],-1),Q=e("p",null,[e("strong",null,"Developers"),e("br"),t(" Developers get a complete data connection toolkit with REST and GraphQL APIs, a JavaScript SDK, access to global variables to customize configuration options, and direct command-line access to digital assets.")],-1),B=e("p",null,[e("strong",null,"Power Users"),e("br"),t(" Data analysts and data scientists have in-app tools to query data, build out in-app analytics dashboards, and extract or upload data in file format. Additionally, these users are still free to link other services and run raw SQL queries directly on the database.")],-1),z=e("p",null,[e("strong",null,"Business Users"),e("br"),t(" The no-code app is safe and intuitive enough to make data accessible to everyone, even the most non-technical users. Administrators can create fully granular permissions for roles as well as individual users.")],-1),F={class:"tip hint"},M=e("div",{class:"hint-title"},"Directus Vocabulary",-1),N=t("In order keep things simpler, "),R=e("em",null,"especially for the no-code users",-1),U=t(", Directus uses friendlier names for many database terms and technical concepts, including "),W=t("Project"),G=t(" (database), "),O=t("Collection"),K=t(" (table), "),V=t("Field"),Y=t(" (column), "),H=t("Item"),J=t(" (record), and "),X=t("Type"),Z=t(" (datatype)."),$=e("h2",{id:"when-to-use-it",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#when-to-use-it"},"#"),t(" When to Use It")],-1),ee=e("p",null,[e("strong",null,"Directus can power any data-driven project and can be linked or removed at any time.")],-1),te=e("p",null,[t("Build, monitor or manage any data model or app you desire: IoT fleets, e-commerce, SaaS, business data analytics, multi-channel content, "),e("em",null,"or anything else!"),t(" If it involves SQL and digital files, you can link up Directus. With this in mind, four broad use cases do emerge:")],-1),oe=e("p",null,[e("strong",null,"Backend as a Service"),e("br"),t(" An end-to-end data solution. Efficiently connects data, auto-generates exhaustive APIs for projects that scale, and provides webhooks and task automation. Completely detached from the database, you\u2019re free to link and remove Directus anytime or use any other service in tandem.")],-1),se=e("p",null,[e("strong",null,"Headless CMS"),e("br"),t(" Remember, "),e("em",null,"content"),t(" is just data from a database! Manage any omnichannel digital experience. Deliver file assets and data across websites, apps, kiosks, digital signage\u2026 "),e("em",null,"the sky\u2019s the limit!")],-1),ae=e("p",null,[e("strong",null,"Internal Tool Builder"),e("br"),t(" The whole team can build custom apps! Ditch the spreadsheet and quickly build back-office apps and admin panels for customers, inventory, projects, marketing, "),e("em",null,"or anything else.")],-1),ne=e("p",null,[e("strong",null,"Data Management and Analytics"),e("br"),t(" Establish "),e("em",null,"a single source of truth"),t(" for all data. Build no-code analytics dashboards to gain insights into company KPIs and other metrics. Coalesce previously siloed department data.")],-1),ie=e("h2",{id:"why-use-it%3F",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#why-use-it%3F"},"#"),t(" Why Use It?")],-1),re=e("p",null,[e("strong",null,"Directus is a simple, data-first solution to complex problems with no downsides.")],-1),le=e("p",null,[t("Directus was created in 2004 and has been slowly, iteratively improved on for a long time. The core team has carefully thought through the app, beginning to end, and strives to make this platform is an all-benefit and no downside experience. It is also plug-and-play, so you\u2019re free to link or remove it anytime, with zero impact on your data. You have no vendor lock-in whatsoever, "),e("em",null,"your data is yours"),t(". There are no artificial data limits "),e("em",null,"(e.g. limits on users or roles)"),t(".")],-1),de=e("p",null,[t("Consider competing platforms in the four general use cases "),e("a",{href:"#when-to-use-it"},"mentioned above"),t(". Due diligence to select a viable solution from one of these categories can easily take six months to ensure the feature list, pricing, scalability, migration options, etc\u2026 all match the project in question. However, with Directus, that\u2019s not the case! You can test it immediately on an existing database or build a new data model from scratch, "),e("em",null,"with no impact on your data and no long-term commitments.")],-1),ce=e("p",null,"The following core principles guide this platform:",-1),ue=e("li",null,[e("strong",null,"Pure"),t(" \u2014 No predefined or proprietary schema, with all system metadata stored separately.")],-1),he=e("li",null,[e("strong",null,"Open"),t(" \u2014 Directus Core is public and open source, with no obfuscated or cloud-only code.")],-1),pe=e("li",null,[e("strong",null,"Portable"),t(" \u2014 The database can be exported or migrated anytime, so there\u2019s no vendor lock-in.")],-1),me=e("strong",null,"Limitless",-1),_e=t(" \u2014 No artificial limits or paywalls on users, roles, languages, "),ge=t("Collections"),fe=t(", or "),ye=t("Items"),be=t("."),we=e("li",null,[e("strong",null,"Extensible"),t(" \u2014 Every aspect of this platform is modular to avoid any hard feature ceiling.")],-1),ve=e("li",null,[e("strong",null,"Unopinionated"),t(" \u2014 Choose the stack, database, and architecture as you wish.")],-1),De=e("h2",{id:"directus-cloud",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#directus-cloud"},"#"),t(" Directus Cloud")],-1),ke=e("p",null,[e("strong",null,"Directus Cloud is the fastest and easiest way to get your Directus Projects going.")],-1),xe=t("Cloud architecture can be complicated and resource-intensive. Directus Cloud provides scalable, optimized storage and infrastructure, and automatic updates so developers can focus on the app\u2019s core business logic. Directus Cloud also offers "),Te=t("Cloud Exclusive Extensions"),Ie=t(", enhancing Directus Core with even more features."),Ce=e("p",null,"With free Directus Cloud account, you can set up Teams to organize Projects, Project billing, and other Team Members however you need. You\u2019ll be able to get a Project running in about 90 seconds. Then as Project growth changes over time, scale service up or down as needed at the click of a button. The cloud dashboard also provides simple, straightforward analytics to help understand traffic and inform scaling decisions.",-1),Se={class:"tip hint"},Ae=e("div",{class:"hint-title"},"Ready to try Directus Cloud?",-1),je=t("Setup your free Cloud account and learn Directus hands-on in the "),Pe=t("Quickstart Guide"),Ee=t("."),Le=e("div",{class:"tip hint"},[e("div",{class:"hint-title"},"Enterprise Cloud"),e("p",null,[t("Need advanced configuration, unlimited scalability, and dedicated support? "),e("a",{href:"https://directus.io/contact",target:"_blank",rel:"noopener noreferrer"},"Contact us")])],-1),Fe="Introduction",Me=!1,Ne="An introduction to what Directus is, how it works, who it is for, and when to use it.",Re="8 min read",Ue={name:"introduction",setup(qe,{expose:r}){const n={title:"Introduction",modularExtension:!1,description:"An introduction to what Directus is, how it works, who it is for, and when to use it.",readTime:"8 min read"};return r({frontmatter:n}),(Qe,Be)=>{const s=i("router-link"),l=i("docs-wrapper");return d(),c(l,{frontmatter:n},{default:o(()=>[e("div",u,[h,p,m,_,g,f,y,b,w,v,D,e("div",k,[x,e("p",null,[T,a(s,{to:"/docs/getting-started/quickstart"},{default:o(()=>[I]),_:1}),C])]),S,A,j,P,E,L,q,Q,B,z,e("div",F,[M,e("p",null,[N,R,U,a(s,{to:"/docs/getting-started/glossary#projects"},{default:o(()=>[W]),_:1}),G,a(s,{to:"/docs/getting-started/glossary#collections"},{default:o(()=>[O]),_:1}),K,a(s,{to:"/docs/getting-started/glossary#fields"},{default:o(()=>[V]),_:1}),Y,a(s,{to:"/docs/getting-started/glossary#items"},{default:o(()=>[H]),_:1}),J,a(s,{to:"/docs/getting-started/glossary#types"},{default:o(()=>[X]),_:1}),Z])]),$,ee,te,oe,se,ae,ne,ie,re,le,de,ce,e("ul",null,[ue,he,pe,e("li",null,[me,_e,a(s,{to:"/docs/getting-started/glossary#collections"},{default:o(()=>[ge]),_:1}),fe,a(s,{to:"/docs/getting-started/glossary#items"},{default:o(()=>[ye]),_:1}),be]),we,ve]),De,ke,e("p",null,[xe,a(s,{to:"/docs/cloud/glossary#cloud-exclusives"},{default:o(()=>[Te]),_:1}),Ie]),Ce,e("div",Se,[Ae,e("p",null,[je,a(s,{to:"/docs/getting-started/quickstart"},{default:o(()=>[Pe]),_:1}),Ee])]),Le])]),_:1})}}};export{Ue as default,Ne as description,Me as modularExtension,Re as readTime,Fe as title};
+import{a as i,o as d,b as c,w as o,l as e,e as a,E as t}from"./runtime-core.esm-bundler.32cac88a.js";const u={class:"markdown-body"},h=e("blockquote",null,[e("p",null,"These Docs will help you get Directus up-and-running quickly, guide you through advanced features, and explain the core concepts that make Directus so unique.")],-1),p=e("h2",{id:"what-is-directus%3F",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#what-is-directus%3F"},"#"),t(" What is Directus?")],-1),m=e("div",{class:"tip hint"},[e("div",{class:"hint-title"},"Directus"),e("p",null,[t("Directus ("),e("a",{href:"http://audio.pronouncekiwi.com/Salli/Directus",target:"_blank",rel:"noopener noreferrer"},"duh REKT iss"),t(") is Latin for: "),e("em",null,"laid straight, arranged in lines"),t("."),e("br"),t(" The broadest goal of our platform is to present data in a simple, orderly, and intuitive way.")])],-1),_=e("p",null,[e("strong",null,"Directus is an Open Data Platform built to democratize the database."),e("br"),t(" This platform provides everyone on your team, "),e("em",null,"regardless of technical skill"),t(", equal access to data and digital file asset management, for any data model or project. First, link Directus to your desired SQL database and file storage adapter. After that, Directus enables you to perform CRUD operations, create users, assign roles with fully configurable permissions, build complex and granular queries, configure event-driven webhooks and task automation\u2026 "),e("em",null,"the list goes on!")],-1),g=e("p",null,[e("strong",null,"Database Introspection & Abstraction"),e("br"),t(" SQL flavors all come with slightly different data types and idiosyncrasies. Directus uses "),e("a",{href:"#how-it-works"},"Database Introspection"),t(" to read your database structure and create an abstraction layer to handle all the nitty-gritty details behind the scenes. This technique works seamlessly with any major SQL database. It also lets you link Directus to your new or pre-existing database or remove it anytime, with no impact on your existing data model. That means you\u2019ll never encounter vendor lock-in.")],-1),f=e("p",null,[e("strong",null,"The App and APIs"),e("br"),t(" Once your database is introspected and abstracted, Directus dynamically generates REST and GraphQL API endpoints to manage your data with granular control. You also get CLI tools for file management and a complete JavaScript SDK.")],-1),y=e("p",null,[t("The API and CLI power the no-code App. In other words, the App is just a GUI that provides no-code access to the API. This architecture is how Directus democratizes the database and provides control to "),e("a",{href:"#who-s-it-for"},"the whole team"),t(".")],-1),b=e("p",null,[e("strong",null,"Open-Source, Modular, Extensible, Scalable"),e("br"),t(" At the highest level, Directus organizes its features and functionality into Modules. Each Module allows you to interact with data in some specific way, such as data and content management, digital file asset management, drag and drop analytics dashboard creation, or whatever. If you find Directus is missing something that your project needs, no problem!")],-1),w=e("p",null,[t("Built entirely in Typescript, primarily on "),e("a",{href:"https://nodejs.dev",target:"_blank",rel:"noopener noreferrer"},"Node.js"),t(" and "),e("a",{href:"https://vuejs.org",target:"_blank",rel:"noopener noreferrer"},"Vue.js"),t(", Directus is 100% open-source, modular and extensible, ensuring your project never hits a hard feature ceiling. The platform scales without issue, "),e("em",null,"and some Projects have hundreds of millions of users.")],-1),v=e("p",null,[t("You can use it with any "),e("em",null,"(or many)"),t(" stacks or frontend frameworks.")],-1),D=e("p",null,[e("strong",null,"Custom Configuration Options"),e("br"),t(" Extensive configuration options are also available as global variables in the codebase. Developers can custom configure SSO authentication method, caching details, default file storage location (local, S3, google, etc.) for digital assets, emails, "),e("em",null,"and much more.")],-1),k={class:"tip hint"},x=e("div",{class:"hint-title"},"Ready to dive in?",-1),T=t("Get a free project running in minutes. Learn Directus hands-on in the "),I=t("Quickstart Guide"),C=t("."),S=e("h2",{id:"how-it-works",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#how-it-works"},"#"),t(" How It Works")],-1),A=e("p",null,[e("strong",null,[t("Directus is installed as a "),e("em",null,"layer"),t(" on top of your new or existing SQL database.")])],-1),j=e("p",null,[t("The App and API dynamically "),e("em",null,"\u201Cmirror\u201D"),t(" your actual schema and content in real-time. This is similar to how technical database clients (like "),e("em",null,"phpMyAdmin"),t(") work. However, Database Introspection has many unique advantages:")],-1),P=e("ul",null,[e("li",null,"Absolute control over your pure SQL database schema."),e("li",null,"Complete transparency, portability, and security for your data."),e("li",null,"Allows importing existing databases, unaltered and without migrations."),e("li",null,"Direct database access and the full power of raw, complex SQL queries."),e("li",null,"Significant performance improvements through optimizations and indexing.")],-1),E=e("p",null,[t("In contrast, other platforms typically use a predefined or proprietary "),e("em",null,"one-size-fits-all"),t(" data model to store content . That is not the case with Directus. Directus gives you direct access to your pure and unaltered data. That means you have the option to bypass the Directus middleware (API, SDK, App) and connect to your data with proper SQL queries. This effectively removes all bottlenecks, latency overhead, and proprietary access limitations.")],-1),L=e("h2",{id:"who%E2%80%99s-it-for%3F",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#who%E2%80%99s-it-for%3F"},"#"),t(" Who\u2019s It For?")],-1),q=e("p",null,[e("strong",null,"Directus lets the whole team work together and access data in one place.")],-1),Q=e("p",null,[e("strong",null,"Developers"),e("br"),t(" Developers get a complete data connection toolkit with REST and GraphQL APIs, a JavaScript SDK, access to global variables to customize configuration options, and direct command-line access to digital assets.")],-1),z=e("p",null,[e("strong",null,"Power Users"),e("br"),t(" Data analysts and data scientists have in-app tools to query data, build out in-app analytics dashboards, and extract or upload data in file format. Additionally, these users are still free to link other services and run raw SQL queries directly on the database.")],-1),B=e("p",null,[e("strong",null,"Business Users"),e("br"),t(" The no-code app is safe and intuitive enough to make data accessible to everyone, even the most non-technical users. Administrators can create fully granular permissions for roles as well as individual users.")],-1),F={class:"tip hint"},M=e("div",{class:"hint-title"},"Directus Vocabulary",-1),N=t("In order keep things simpler, "),R=e("em",null,"especially for the no-code users",-1),U=t(", Directus uses friendlier names for many database terms and technical concepts, including "),W=t("Project"),G=t(" (database), "),O=t("Collection"),K=t(" (table), "),V=t("Field"),Y=t(" (column), "),H=t("Item"),J=t(" (record), and "),X=t("Type"),Z=t(" (datatype)."),$=e("h2",{id:"when-to-use-it",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#when-to-use-it"},"#"),t(" When to Use It")],-1),ee=e("p",null,[e("strong",null,"Directus can power any data-driven project and can be linked or removed at any time.")],-1),te=e("p",null,[t("Build, monitor or manage any data model or app you desire: IoT fleets, e-commerce, SaaS, business data analytics, multi-channel content, "),e("em",null,"or anything else!"),t(" If it involves SQL and digital files, you can link up Directus. With this in mind, four broad use cases do emerge:")],-1),oe=e("p",null,[e("strong",null,"Backend as a Service"),e("br"),t(" An end-to-end data solution. Efficiently connects data, auto-generates exhaustive APIs for projects that scale, and provides webhooks and task automation. Completely detached from the database, you\u2019re free to link and remove Directus anytime or use any other service in tandem.")],-1),se=e("p",null,[e("strong",null,"Headless CMS"),e("br"),t(" Remember, "),e("em",null,"content"),t(" is just data from a database! Manage any omnichannel digital experience. Deliver file assets and data across websites, apps, kiosks, digital signage\u2026 "),e("em",null,"the sky\u2019s the limit!")],-1),ae=e("p",null,[e("strong",null,"Internal Tool Builder"),e("br"),t(" The whole team can build custom apps! Ditch the spreadsheet and quickly build back-office apps and admin panels for customers, inventory, projects, marketing, "),e("em",null,"or anything else.")],-1),ne=e("p",null,[e("strong",null,"Data Management and Analytics"),e("br"),t(" Establish "),e("em",null,"a single source of truth"),t(" for all data. Build no-code analytics dashboards to gain insights into company KPIs and other metrics. Coalesce previously siloed department data.")],-1),ie=e("h2",{id:"why-use-it%3F",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#why-use-it%3F"},"#"),t(" Why Use It?")],-1),re=e("p",null,[e("strong",null,"Directus is a simple, data-first solution to complex problems with no downsides.")],-1),le=e("p",null,[t("Directus was created in 2004 and has been slowly, iteratively improved on for a long time. The core team has carefully thought through the app, beginning to end, and strives to make this platform is an all-benefit and no downside experience. It is also plug-and-play, so you\u2019re free to link or remove it anytime, with zero impact on your data. You have no vendor lock-in whatsoever, "),e("em",null,"your data is yours"),t(". There are no artificial data limits "),e("em",null,"(e.g. limits on users or roles)"),t(".")],-1),de=e("p",null,[t("Consider competing platforms in the four general use cases "),e("a",{href:"#when-to-use-it"},"mentioned above"),t(". Due diligence to select a viable solution from one of these categories can easily take six months to ensure the feature list, pricing, scalability, migration options, etc\u2026 all match the project in question. However, with Directus, that\u2019s not the case! You can test it immediately on an existing database or build a new data model from scratch, "),e("em",null,"with no impact on your data and no long-term commitments.")],-1),ce=e("p",null,"The following core principles guide this platform:",-1),ue=e("li",null,[e("strong",null,"Pure"),t(" \u2014 No predefined or proprietary schema, with all system metadata stored separately.")],-1),he=e("li",null,[e("strong",null,"Open"),t(" \u2014 Directus Core is public and open source, with no obfuscated or cloud-only code.")],-1),pe=e("li",null,[e("strong",null,"Portable"),t(" \u2014 The database can be exported or migrated anytime, so there\u2019s no vendor lock-in.")],-1),me=e("strong",null,"Limitless",-1),_e=t(" \u2014 No artificial limits or paywalls on users, roles, languages, "),ge=t("Collections"),fe=t(", or "),ye=t("Items"),be=t("."),we=e("li",null,[e("strong",null,"Extensible"),t(" \u2014 Every aspect of this platform is modular to avoid any hard feature ceiling.")],-1),ve=e("li",null,[e("strong",null,"Unopinionated"),t(" \u2014 Choose the stack, database, and architecture as you wish.")],-1),De=e("h2",{id:"directus-cloud",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#directus-cloud"},"#"),t(" Directus Cloud")],-1),ke=e("p",null,[e("strong",null,"Directus Cloud is the fastest and easiest way to get your Directus Projects going.")],-1),xe=t("Cloud architecture can be complicated and resource-intensive. Directus Cloud provides scalable, optimized storage and infrastructure, and automatic updates so developers can focus on the app\u2019s core business logic. Directus Cloud also offers "),Te=t("Cloud Exclusive Extensions"),Ie=t(", enhancing Directus Core with even more features."),Ce=e("p",null,"With free Directus Cloud account, you can set up Teams to organize Projects, Project billing, and other Team Members however you need. You\u2019ll be able to get a Project running in about 90 seconds. Then as Project growth changes over time, scale service up or down as needed at the click of a button. The cloud dashboard also provides simple, straightforward analytics to help understand traffic and inform scaling decisions.",-1),Se={class:"tip hint"},Ae=e("div",{class:"hint-title"},"Ready to try Directus Cloud?",-1),je=t("Setup your free Cloud account and learn Directus hands-on in the "),Pe=t("Quickstart Guide"),Ee=t("."),Le=e("div",{class:"tip hint"},[e("div",{class:"hint-title"},"Enterprise Cloud"),e("p",null,[t("Need advanced configuration, unlimited scalability, and dedicated support? "),e("a",{href:"https://directus.io/contact",target:"_blank",rel:"noopener noreferrer"},"Contact us")])],-1),Fe="Introduction",Me=!1,Ne="An introduction to what Directus is, how it works, who it is for, and when to use it.",Re="8 min read",Ue={name:"introduction",setup(qe,{expose:r}){const n={title:"Introduction",modularExtension:!1,description:"An introduction to what Directus is, how it works, who it is for, and when to use it.",readTime:"8 min read"};return r({frontmatter:n}),(Qe,ze)=>{const s=i("router-link"),l=i("docs-wrapper");return d(),c(l,{frontmatter:n},{default:o(()=>[e("div",u,[h,p,m,_,g,f,y,b,w,v,D,e("div",k,[x,e("p",null,[T,a(s,{to:"/docs/getting-started/quickstart"},{default:o(()=>[I]),_:1}),C])]),S,A,j,P,E,L,q,Q,z,B,e("div",F,[M,e("p",null,[N,R,U,a(s,{to:"/docs/getting-started/glossary#projects"},{default:o(()=>[W]),_:1}),G,a(s,{to:"/docs/getting-started/glossary#collections"},{default:o(()=>[O]),_:1}),K,a(s,{to:"/docs/getting-started/glossary#fields"},{default:o(()=>[V]),_:1}),Y,a(s,{to:"/docs/getting-started/glossary#items"},{default:o(()=>[H]),_:1}),J,a(s,{to:"/docs/getting-started/glossary#types"},{default:o(()=>[X]),_:1}),Z])]),$,ee,te,oe,se,ae,ne,ie,re,le,de,ce,e("ul",null,[ue,he,pe,e("li",null,[me,_e,a(s,{to:"/docs/getting-started/glossary#collections"},{default:o(()=>[ge]),_:1}),fe,a(s,{to:"/docs/getting-started/glossary#items"},{default:o(()=>[ye]),_:1}),be]),we,ve]),De,ke,e("p",null,[xe,a(s,{to:"/docs/cloud/glossary#cloud-exclusives"},{default:o(()=>[Te]),_:1}),Ie]),Ce,e("div",Se,[Ae,e("p",null,[je,a(s,{to:"/docs/getting-started/quickstart"},{default:o(()=>[Pe]),_:1}),Ee])]),Le])]),_:1})}}};export{Ue as default,Ne as description,Me as modularExtension,Re as readTime,Fe as title};