You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit a92502a
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: docs/get-started/create-a-project/index.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,7 @@ description: Create new websites and packages in Nordcraft with this step-by-ste
5
5
6
6
# Create a new project in Nordcraft
7
7
8
-
In Nordcraft, you can create a [website](/get-started/overview#apps) or a [package](/get-started/overview#packages). A website is a standalone website, while packages are used to bundle up smaller bits of reusable functionality to use in Nordcraft projects.
8
+
In Nordcraft, you can create a [website](/get-started/overview#websites) or a [package](/get-started/overview#packages). A website is a standalone website, while packages are used to bundle up smaller bits of reusable functionality to use in Nordcraft projects.
Copy file name to clipboardExpand all lines: docs/the-editor/bottom-bar/index.md
+3-7Lines changed: 3 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,18 +10,14 @@ The bottom bar provides quick access to frequently used actions and tools in the
10
10

11
11
12
12
1.**Ask AI**: Get help from the Nordcraft AI Assistant
13
-
2.**Current collaborators**: All users currently working in the same branch of the project
13
+
2.**Current collaborators**: All team members currently working in the same branch of the project
14
14
3.**Undo/Redo**: Undo and redo changes in the editor
15
15
4.**Zoom controls**: View the current zoom level (adjusted by pressing [kbd]Cmd/Ctrl[kbd] + [kbd]scroll[kbd]), and use the magnifying glass to reset the zoom level to 100%
16
16
5.**Test mode**: Toggle between editing and testing your website
17
-
6.[Export as web component](/components/export-a-component): Export the current component as a web component for use in other web projects
17
+
6.[Export as web component](/components/export-a-component): Export the current component as a web component for use in other web projects (only visible when editing a component)
18
18
7.**Preview**: Open the current page in a new browser tab
19
19
8.**Insert element**: Open the element catalog to insert a new HTML element
20
20
21
-
::: info
22
-
The [kbd]Export as web component[kbd] button is only available when editing components, not pages.
23
-
:::
24
-
25
21
::: tip
26
-
When testing interactive features, use preview mode for a more accurate representation of how your website will behave.
22
+
When testing interactive features, use preview mode (opens in a new browser tab) for a more accurate representation of how your website will behave.
Copy file name to clipboardExpand all lines: docs/the-editor/canvas/index.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,7 @@ description: Learn to navigate, select elements, and resize the canvas workspace
5
5
6
6
# Canvas
7
7
8
-
The canvas is the central workspace in the Nordcraft editor where you visually build and interact with your website.
8
+
The canvas is your central workspace in the Nordcraft editor where you visually build and interact with your website.
9
9
10
10
{https://editor.nordcraft.com/projects/docs_examples/branches/main/components/screenshot-page?rightpanel=events&canvas-width=1077.6&canvas-height=800&mode=test}
11
11
@@ -34,5 +34,5 @@ You can drag and drop elements around the canvas to reorder or move an element t
34
34
The Nordcraft editor provides several keyboard shortcuts to help you work faster. Head over to the [shortcuts](/the-editor/shortcuts#canvas-resizing-shortcuts) page to learn about resizing shortcuts.
35
35
36
36
::: info
37
-
All links in the canvas open in a new tab to maintain editor synchronization. To test links as they'll work in your final website, use the preview functionality.
37
+
All HTML anchor tag links (`<a>`) in the canvas open in a new tab. To test links as they'll work in your final website, use the preview functionality.
The data panel is the central hub for managing all data aspects of your pages and components in Nordcraft. It allows you to define variables, connect to APIs, create formulas, and establish workflows that power your website's functionality.
8
+
The data panel is for managing all data aspects of your pages and components in Nordcraft. It allows you to define variables, connect to APIs, create formulas, workflows, and configure on load and on attribute change events.
9
9
10
10
{https://editor.nordcraft.com/projects/docs_examples/branches/main/components/screenshot-page?rightpanel=style&canvas-width=800&canvas-height=800}
11
11
@@ -17,7 +17,7 @@ The data panel is only visible when no element is selected. Press [kbd]Escape[kb
17
17
18
18
## Structure
19
19
20
-
Pages and components have several data sections that provide essential functionality.
20
+
The data panel is split into several sections tailored to specific functionality.
21
21
22
22
### Page
23
23
@@ -37,19 +37,19 @@ Store and manage state within your page or component. Variables can be initializ
37
37
38
38
### APIs
39
39
40
-
Connect your website to external services and data sources by defining endpoints, configuring request parameters and HTTP methods, and handling responses.
40
+
Connect your website to external services and back-end data sources by defining endpoints, configuring request parameters and HTTP methods, and handling responses.
41
41
42
42
### Events
43
43
44
44
Enable components to communicate with parent elements through custom events that can be triggered by internal actions and pass data upward.
45
45
46
46
### Formulas
47
47
48
-
Create reusable calculations and data transformations using Nordcraft's formula syntax to access data from variables, formulas, contexts and API responses.
48
+
Create reusable calculations and data transformations using the formula editor to access data from variables, formulas, contexts and API responses.
49
49
50
50
### Workflows
51
51
52
-
Build multi-step processes to handle complex interactions by combining workflows and actions in sequence with conditional logic.
52
+
Build multi-step processes to handle interactivity by combining workflows and actions in sequence with conditional logic.
53
53
54
54
### Contexts
55
55
@@ -64,14 +64,4 @@ Control what happens at specific moments in your component or page lifecycle:
64
64
65
65
### Dependents
66
66
67
-
View all components that rely on the current component to track usage throughout your project and assess the impact of potential changes.
68
-
69
-
## Using the data panel
70
-
71
-
The data panel is fundamental to creating dynamic experiences in Nordcraft:
72
-
73
-
- Define your data model using variables and APIs
74
-
- Create formulas to transform and present your data
75
-
- Implement workflows to handle user interactions
76
-
- Configure lifecycle actions to initialize your website's state
77
-
- Set up proper communication between components using events and contexts
67
+
View all components that rely on the current component to track usage throughout your project.
Copy file name to clipboardExpand all lines: docs/the-editor/element-panel/index.md
+22-24Lines changed: 22 additions & 24 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,25 +5,25 @@ description: Customize element styling, attributes and events to control appeara
5
5
6
6
# Element panel
7
7
8
-
The element panel appears in the right side of the editor when an element is selected. It provides detailed controls for the appearance, attributes and interactivity of the selected element.
8
+
The element panel appears in the right side of the editor when an element is selected, allowing you to configure CSS styling, HTML attributes, and events for the selected element.
9
9
10
10
{https://editor.nordcraft.com/projects/docs_examples/branches/main/components/card?selection=nodes.root&rightpanel=style&canvas-width=800&canvas-height=800}
11
11
12
12
When you select an element in the canvas or element tree, the element panel displays configuration options for that specific element. The panel has three tabs:
13
13
14
-
1.[Styling](#style-panel): Configure visual appearance and layout for the element and its children
15
-
2.[Attributes](#attributes-panel): Set HTML or component attributes for advanced behaviors
16
-
3.[Events](#events-panel): Define workflows triggered by user interactions on the element
14
+
1.[Styling](#style-panel): Configure CSS styles for the element and its children
15
+
2.[Attributes](#attributes-panel): Set HTML or component attributes
16
+
3.[Events](#events-panel): Create workflows triggered by user interactions on the element
17
17
18
18
## Style panel
19
19
20
-
The style panel allows you to control the visual appearance of elements and components.
20
+
The style panel provides a visual interface to edit the CSS of elements and components. All styles generated are in pure CSS syntax, which you can inspect as code using the CSS editor.
21
21
22
22
{https://editor.nordcraft.com/projects/docs_examples/branches/main/components/card?selection=nodes.root&rightpanel=style&canvas-width=800&canvas-height=800}
23
23
24
-
1.Add or override [CSS variables](#css-variables)
25
-
2.Define [style](#style) variants (e.g. styles for hover, active and disabled states in addition to the default state)
26
-
3.Search for CSS properties; if they exist on the style panel you will be taken to that area in the style panel
24
+
1.Define [style](#style) variants (e.g. styles for hover, active and disabled states in addition to the default state)
25
+
2.Search for CSS properties; if they exist on the style panel you will be taken to that area in the style panel
26
+
3.Add or override [CSS variables](#css-variables)
27
27
4. Set [CSS properties](#css-properties) for the selected style variant
28
28
5. Use the [CSS editor](#css-editor) to configure styles using standard CSS code
29
29
@@ -35,55 +35,53 @@ The style panel allows you to control the visual appearance of elements and comp
35
35
- Override theme variables at the element level for specific use cases or set a local-only variable
36
36
- Set up CSS variables in the formula editor to create dynamic, conditional styles
37
37
- Define the type, name and set a unit if needed (e.g. `px`)
38
-
-These CSS variables are available for use in CSS properties in the style panel
39
-
-Animate or transition CSS variables for smooth visual effects. CSS variables must be defined in your theme with the correct [syntax type](/styling/theme#theme-variables) to be animated correctly.
38
+
-All CSS variables are available for use in CSS properties in the style panel
39
+
- CSS variables must be defined in your theme with the correct [syntax type](/styling/theme#theme-variables) to be animated correctly.
40
40
41
41
### Style
42
42
43
43
The style section manages different visual variants of your element.
44
44
45
45
- Every element has a `Default` style applied
46
-
- Add variants with pseudo-classes (e.g. `:hover`, `:active`, `:focus-visible`) and pseudo-elements (e.g. ::before, ::after, ::selection)
46
+
- Add variants with pseudo-classes (e.g. `:hover`, `:active`, `:focus-visible`) and pseudo-elements (e.g. `::before`, `::after`, `::selection`)
47
47
- Create variants using CSS classes you defined in the attributes panel
48
48
- Set up responsive styles with media queries for different screen sizes
49
49
- Combine classes, pseudo-classes and media queries for more complex style variants
50
-
- When styling a component instance, you can select and style a component's class from the outside (see [component style overrides](/styling/conditional-styles#component-style-overrides))
50
+
- When styling a component, you can select and style a component's class from the outside (see [component style overrides](/styling/conditional-styles#component-style-overrides))
51
51
52
52
### CSS properties
53
53
54
54
The CSS properties section provides an interface to set styling properties. All properties defined are generated as pure CSS code in your projects.
55
55
56
56
- Properties are organized into logical groups like size, layout, text, background, shadow, effects, transform, transition and advanced
57
-
- Use the `Advanced` section to set any CSS property not (yet) natively supported
57
+
- Use the `Advanced` section to set any CSS property not (yet) natively supported in the Nordcraft editor
58
58
- Use the search field to quickly find specific CSS properties
59
-
- View the number of properties set in the current style at the bottom
60
-
- Copy and paste styles or switch to the CSS editor view using buttons at the bottom of the panel
59
+
- View the number of properties set in the current style at the bottom of the style panel
60
+
- Copy and paste styles or switch to the CSS editor view using buttons at the bottom of the style panel
61
61
62
62
### CSS Editor
63
63
64
64
{https://editor.nordcraft.com/projects/docs_examples/branches/main/components/card-container?rightpanel=style&canvas-width=800&selection=nodes.root&canvas-height=800}
65
65
66
-
- The CSS editor provides a code view to view and edit styles directly using CSS syntax
66
+
- The CSS editor provides a code view to inspect and edit styles directly using CSS syntax
67
67
- All styles you define using the style panel are displayed, including style variants
68
-
- Changes made here are automatically applied to the standard view
69
-
70
-
This view is particularly useful for developers comfortable with writing CSS directly or for making multiple property changes efficiently.
68
+
- Changes made here are automatically applied to the visual style panel view
71
69
72
70
## Attributes panel
73
71
74
-
The attributes panel allows you to configure the element HTML tag, attributes, classes and special behaviors like conditional display and repetition for the selected element.
72
+
The attributes panel allows you to configure the element HTML tag, attributes, classes and special behaviors like conditional display (show/hide) and the repeat formula for the selected element.
75
73
76
74
{https://editor.nordcraft.com/projects/docs_examples/branches/main/components/card?selection=nodes.root&rightpanel=attributes&canvas-width=800&canvas-height=800}
77
75
78
76
### Element tag
79
77
80
-
- Select the HTML tag for your element (not available for components)
78
+
- Select the HTML tag for your element (available for HTML elements only)
81
79
- Changing the tag allows you to modify the element's behavior while preserving its contents and styling
82
80
83
81
### Attributes
84
82
85
83
- Add attributes to the element by clicking the [kbd]+[kbd] button and entering a name
86
-
- Define attribute values directly or bind them to variables or formulas for dynamic content
84
+
- Define attribute values directly or bind them to variables or formulas
87
85
- Some element tags have predefined attributes (e.g. `type` for input elements)
88
86
- For components, you can only set the attributes that have been specifically defined for that component
89
87
@@ -109,8 +107,8 @@ The events panel enables you to define interactive behaviors that respond to use
109
107
110
108
{https://editor.nordcraft.com/projects/docs_examples/branches/main/components/card?selection=nodes.root&rightpanel=events&canvas-width=800&canvas-height=800}
111
109
112
-
- Events are categorized into logical groups (click, keyboard, form, input, touch, etc.) for easier navigation
113
-
- Events with assigned workflows or actions are highlighted and appear in the **Active** section at the top
110
+
- Events are categorized into groups (click, keyboard, form, input, touch, etc.)
111
+
- Events with assigned workflows or actions are highlighted and appear in the **Active** section at the top of the panel
114
112
- Bind workflows, global actions, or trigger component events to any available event
115
113
116
114
For a complete list of available HTML element events, refer to the [MDN documentation event reference](https://developer.mozilla.org/en-US/docs/Web/Events).
Copy file name to clipboardExpand all lines: docs/the-editor/element-tree/index.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,15 +5,15 @@ description: Understand the Nordcraft element tree for structural editing, eleme
5
5
6
6
# Element tree
7
7
8
-
The element tree provides a structural overview of your project, displaying all HTML elements and Nordcraft components in your page or component hierarchically.
8
+
The element tree provides a structural overview of your project, displaying all HTML elements and Nordcraft components in your page or component.
9
9
10
10
{https://editor.nordcraft.com/projects/docs_examples/branches/main/components/screenshot-page?canvas-width=800&canvas-height=800}
11
11
12
12
## Navigation and selection
13
13
14
14
- Elements are named according to their HTML tag or component name
15
-
-Toggle visibility of child elements using the triangle icon to collapse sections
16
-
-Select elements by clicking on them, just as in the canvas
15
+
-Select elements by clicking on them
16
+
-Toggle visibility of child elements using the triangle icon at the left of the element to collapse or expand sections
17
17
- Drag elements to reorder them within the structure
18
18
19
19
::: info
@@ -32,7 +32,7 @@ Right-clicking an element opens a context menu with several actions.
32
32
33
33
1.**Insert element**: Open the HTML element catalog to choose a new element to insert
34
34
2.**Wrap in element**: Place the currently selected HTML element inside a new parent element and open the HTML catalog
35
-
3.[Extract as component](/components/create-a-component#extract-existing-elements): Convert the HTML element into a reusable component
35
+
3.[Extract as component](/components/create-a-component#extract-existing-elements): Convert the HTML element and all child elements into a reusable component
36
36
4.[Show/hide](/formulas/show-hide-formula): Set a formula to control whether an element or component is visible or not
37
37
5.[Repeat](/formulas/repeat-formula): Set a formula to create multiple instances of an element or component from an array
38
38
6.**Standard operations**: Duplicate, cut, copy, paste and delete
@@ -56,7 +56,7 @@ The element catalog contains all HTML elements and any components available in y
56
56
- Search for project components by name
57
57
- View components from installed packages
58
58
59
-
Click an element to add it to your project. The element will be added as a child of the currently selected element or as the first child of the root element if no element is selected.
59
+
Click an element from the catalogye to add it to the HTML element tree. The element will be added as a child of the currently selected element or as the last child of the root element if no element is selected.
60
60
61
61
::: tip
62
62
If you need to change the tag name of an HTML element, edit its `Tag` in the `Attributes` panel on the right. This saves you having to delete and re-add elements.
0 commit comments