Skip to content

Commit a92502a

Browse files
committed
refresh for the editor
1 parent 05a1c57 commit a92502a

11 files changed

Lines changed: 68 additions & 93 deletions

File tree

‎docs/get-started/create-a-project/index.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: Create new websites and packages in Nordcraft with this step-by-ste
55

66
# Create a new project in Nordcraft
77

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.
99

1010
## Create a project from the dashboard
1111

‎docs/the-editor/bottom-bar/index.md‎

Lines changed: 3 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -10,18 +10,14 @@ The bottom bar provides quick access to frequently used actions and tools in the
1010
![An annotated image focussing on the bar visible at the bottom of the canvas. Annotations correspond to the list items below.|16/9](bottom-bar.webp 'Bottom bar')
1111

1212
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
1414
3. **Undo/Redo**: Undo and redo changes in the editor
1515
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%
1616
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)
1818
7. **Preview**: Open the current page in a new browser tab
1919
8. **Insert element**: Open the element catalog to insert a new HTML element
2020

21-
::: info
22-
The [kbd]Export as web component[kbd] button is only available when editing components, not pages.
23-
:::
24-
2521
::: 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.
2723
:::

‎docs/the-editor/canvas/index.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: Learn to navigate, select elements, and resize the canvas workspace
55

66
# Canvas
77

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.
99

1010
![The Nordcraft canvas viewed in test mode, with no left or right panels visible, showing a card component with an image, headline, subtitle and button.|16/9](canvas.webp 'Canvas'){https://editor.nordcraft.com/projects/docs_examples/branches/main/components/screenshot-page?rightpanel=events&canvas-width=1077.6&canvas-height=800&mode=test}
1111

@@ -34,5 +34,5 @@ You can drag and drop elements around the canvas to reorder or move an element t
3434
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.
3535

3636
::: 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.
3838
:::

‎docs/the-editor/data-panel/index.md‎

Lines changed: 6 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: Configure page settings, component attributes, variables, APIs, eve
55

66
# Data panel
77

8-
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.
99

1010
![The data panel is visible on the right with sections for page configuration, variables, APIs, Formulas, Workflows and Lifecycle.|16/9](data-panel-page.webp 'Data panel page'){https://editor.nordcraft.com/projects/docs_examples/branches/main/components/screenshot-page?rightpanel=style&canvas-width=800&canvas-height=800}
1111

@@ -17,7 +17,7 @@ The data panel is only visible when no element is selected. Press [kbd]Escape[kb
1717

1818
## Structure
1919

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.
2121

2222
### Page
2323

@@ -37,19 +37,19 @@ Store and manage state within your page or component. Variables can be initializ
3737

3838
### APIs
3939

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.
4141

4242
### Events
4343

4444
Enable components to communicate with parent elements through custom events that can be triggered by internal actions and pass data upward.
4545

4646
### Formulas
4747

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.
4949

5050
### Workflows
5151

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.
5353

5454
### Contexts
5555

@@ -64,14 +64,4 @@ Control what happens at specific moments in your component or page lifecycle:
6464

6565
### Dependents
6666

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.

‎docs/the-editor/element-panel/index.md‎

Lines changed: 22 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -5,25 +5,25 @@ description: Customize element styling, attributes and events to control appeara
55

66
# Element panel
77

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.
99

1010
![The element panel is visible, showing options to switch between the style, attributes, and events view as annotations, relating to the list items below.|16/9](element-panel.webp 'Element panel'){https://editor.nordcraft.com/projects/docs_examples/branches/main/components/card?selection=nodes.root&rightpanel=style&canvas-width=800&canvas-height=800}
1111

1212
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:
1313

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
1717

1818
## Style panel
1919

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.
2121

2222
![The Style panel is open showing a number of style properties available to configure on the selected HTML element. It is annotated relating to the list items below.|16/9](element-panel-styling.webp 'Styling'){https://editor.nordcraft.com/projects/docs_examples/branches/main/components/card?selection=nodes.root&rightpanel=style&canvas-width=800&canvas-height=800}
2323

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)
2727
4. Set [CSS properties](#css-properties) for the selected style variant
2828
5. Use the [CSS editor](#css-editor) to configure styles using standard CSS code
2929

@@ -35,55 +35,53 @@ The style panel allows you to control the visual appearance of elements and comp
3535
- Override theme variables at the element level for specific use cases or set a local-only variable
3636
- Set up CSS variables in the formula editor to create dynamic, conditional styles
3737
- 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.
4040

4141
### Style
4242

4343
The style section manages different visual variants of your element.
4444

4545
- 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`)
4747
- Create variants using CSS classes you defined in the attributes panel
4848
- Set up responsive styles with media queries for different screen sizes
4949
- 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))
5151

5252
### CSS properties
5353

5454
The CSS properties section provides an interface to set styling properties. All properties defined are generated as pure CSS code in your projects.
5555

5656
- 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
5858
- 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
6161

6262
### CSS Editor
6363

6464
![The CSS editor is open in the style panel, showing CSS code in an editable IDE-like interface.|16/9](element-panel-css-editor.webp 'CSS editor'){https://editor.nordcraft.com/projects/docs_examples/branches/main/components/card-container?rightpanel=style&canvas-width=800&selection=nodes.root&canvas-height=800}
6565

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
6767
- 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
7169

7270
## Attributes panel
7371

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.
7573

7674
![The attributes panel is visible for the selected HTML element. The HTML element tag is editable via a dropdown, one attribute is specified on the element, and there is an empty classes list and the option to create show formula for this element.|16/9](element-panel-attributes.webp 'Attributes'){https://editor.nordcraft.com/projects/docs_examples/branches/main/components/card?selection=nodes.root&rightpanel=attributes&canvas-width=800&canvas-height=800}
7775

7876
### Element tag
7977

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)
8179
- Changing the tag allows you to modify the element's behavior while preserving its contents and styling
8280

8381
### Attributes
8482

8583
- 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
8785
- Some element tags have predefined attributes (e.g. `type` for input elements)
8886
- For components, you can only set the attributes that have been specifically defined for that component
8987

@@ -109,8 +107,8 @@ The events panel enables you to define interactive behaviors that respond to use
109107

110108
![The events panel is visible in the right sidebar, showing a number of options to add events to HTML elements, including click events, keyboard events, form, input, touch and mouse events, and more.|16/9](element-panel-events.webp 'Events'){https://editor.nordcraft.com/projects/docs_examples/branches/main/components/card?selection=nodes.root&rightpanel=events&canvas-width=800&canvas-height=800}
111109

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
114112
- Bind workflows, global actions, or trigger component events to any available event
115113

116114
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).

‎docs/the-editor/element-tree/index.md‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,15 +5,15 @@ description: Understand the Nordcraft element tree for structural editing, eleme
55

66
# Element tree
77

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.
99

1010
![An expanded view of the HTML element tree, showing an array of HTML elements and Nordcraft components in a hierarchical structure.|16/9](element-tree.webp 'Element tree'){https://editor.nordcraft.com/projects/docs_examples/branches/main/components/screenshot-page?canvas-width=800&canvas-height=800}
1111

1212
## Navigation and selection
1313

1414
- 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
1717
- Drag elements to reorder them within the structure
1818

1919
::: info
@@ -32,7 +32,7 @@ Right-clicking an element opens a context menu with several actions.
3232

3333
1. **Insert element**: Open the HTML element catalog to choose a new element to insert
3434
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
3636
4. [Show/hide](/formulas/show-hide-formula): Set a formula to control whether an element or component is visible or not
3737
5. [Repeat](/formulas/repeat-formula): Set a formula to create multiple instances of an element or component from an array
3838
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
5656
- Search for project components by name
5757
- View components from installed packages
5858

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.
6060

6161
::: tip
6262
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

Comments
 (0)