Material: update the getting-started docs

Author: ogoffart

ui-libraries/material/docs/src/content/docs/getting-started.mdx

@@ -14,84 +14,84 @@ import { Steps, Tabs, TabItem } from '@astrojs/starlight/components';
 Welcome to the documentation for the Material 3 Design System for Slint. Learn more about
 Slint [here](https://slint.dev/).
 
-We recommend using an IDE for development, along with our [LSP-based IDE integration for
-.slint files](https://github.com/slint-ui/slint/blob/master/tools/lsp/README.md). You
-can also load this project directly in [Visual Studio Code](https://code.visualstudio.com/)
-and install our [Slint extension](https://marketplace.visualstudio.com/items?itemName=Slint.slint).
+To start a project from scratch, follow the instructions from one of our template reprositories:
 
-<Tabs>
+<Tabs syncKey="dev-language">
+<TabItem label="C++">
+https://github.com/slint-ui/material-cpp-template
+</TabItem>
 <TabItem label="Rust">
+https://github.com/slint-ui/material-rust-template
+</TabItem>
+<TabItem label="NodeJS">
+https://github.com/slint-ui/material-nodejs-template
+</TabItem>
+<TabItem label="Python" >
+https://github.com/slint-ui/material-python-template
+</TabItem>
+</Tabs>
 
-1. Install Rust by following its [getting-started guide](https://www.rust-lang.org/learn/get-started). Once this is done, you should have the rustc compiler and the cargo build system installed in your `PATH`.
-2. Clone the getting-started repository:
-```bash
-git clone --recurse-submodules https://github.com/slint-ui/material-rust-template.git my-project
-cd my-project
-```
-3. Build the sample application:
-```bash
-cargo build
-```
-4. Run the sample application:
-```bash
-cargo run
-```
+To use the components in your existing project, download the source code of the material component from
+https://material.slint.dev/zip/material-1.0.zip
+and extract it into your repository.
+Then follow the [documentation to configure the use of `@material` as a library](https://docs.slint.dev/latest/docs/slint/guide/language/coding/file/#component-libraries).
 
-With Rust based Slint apps you can also target Web and Android. For more details, see the [template repository](https://github.com/slint-ui/material-rust-template).
+Here's an example of how to configure it for different languages:
 
-</TabItem>
+<Tabs syncKey="dev-language">
 <TabItem label="C++">
-1. Setup the [development environment](https://docs.slint.dev/latest/docs/cpp/cmake).
-2. Clone the getting-started repository:
-```bash
-git clone --recurse-submodules https://github.com/slint-ui/material-cpp-template.git my-project
-cd my-project
+In your `CMakeLists.txt` file, use `LIBRARY_PATHS` in the `slint_target_sources` function.
+
+```cmake
+slint_target_sources(my_application
+    ui/main.slint
+    LIBRARY_PATHS
+        material=${CMAKE_CURRENT_SOURCE_DIR}/material-1.0/material.slint
+)
 ```
-3. Build the sample application:
-```bash
-mkdir build && cd build
-cmake .. -G Ninja
-cmake --build .
-```
-4. Run the sample application:
-```bash
-./my_application
+</TabItem>
+<TabItem label="Rust">
+In your `build.rs`, call `CompilerConfiguration::with_library_paths`
+
+```rust
+// build.rs
+fn main() {
+    let config = slint_build::CompilerConfiguration::new().with_library_paths(
+        std::collections::HashMap::from([(
+            "material".to_string(),
+            std::path::Path::new(&std::env::var_os("CARGO_MANIFEST_DIR").unwrap())
+                .join("material-1.0/material.slint"),
+        )]),
+    );
+    slint_build::compile_with_config("ui/main.slint", config).unwrap();
+}
 ```
 </TabItem>
 <TabItem label="NodeJS">
-
-1. Install [Node.js](https://nodejs.org/) and [npm](https://www.npmjs.com/).
-2. Clone the getting-started repository:
-```bash
-git clone --recurse-submodules https://github.com/slint-ui/material-nodejs-template.git my-project
-cd my-project
-```
-3. Install the dependencies:
-```bash
-npm install
-```
-4. Run the sample application:
-```bash
-npm start
+Provide the `libraryPaths` map with `loadFile`:
+
+```javascript
+let ui = slint.loadFile("ui/main.slint", {
+    libraryPaths: {
+        "material": path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "material-1.0", "material.slint")
+    }
+});
 ```
-
 </TabItem>
-<TabItem label="Python" >
-1. Install [uv](https://docs.astral.sh/uv/).
-2. Clone the getting-started repository:
-```bash
-git clone --recurse-submodules https://github.com/slint-ui/material-python-template.git my-project
-cd my-project
-```
-3. Run the sample application:
-```bash
-uv run main.py
+<TabItem label="Python">
+Provide the `library_paths` dict with `load_file`:
+
+```python
+ui = slint.load_file(
+    Path(__file__).parent / "ui" / "main.slint",
+    library_paths={
+        "material": Path(__file__).parent / "material-1.0" / "material.slint"
+    },
+)
 ```
-
 </TabItem>
 </Tabs>
 
-
 ## Next Steps
 
 All the documentation for Slint's Material UI components can be found on this site.