# Install

*Important: going from version 2.0.0 and forward, flutter-view supports Dart 2.13 and up, enforcing null-safety. This means **breaking changes**. If you have a legacy project, stay at a version below 2.0.0, in both flutter-view and the flutter-view-widgets library which has also been updated.*

## Requirements

Flutter-view is an npm project and requires a working [NodeJS](https://nodejs.org/en/) installation. Of course you should have a working Flutter install as well.

## Installing flutter-view

To install flutter-view, run the following command in your terminal:

> `npm install -g flutter-view`

On a Mac add sudo:

> `sudo npm install -g flutter-view`

*Important: the modern version of flutter-view is for Dart 2.13 and higher, and support type safety. If you have an older project, install* `flutter-view@1.0.3` *instead.*

*Note: you may need to add **--unsafe-perm** for things to work due to an* [*issue with node-gyp*](https://github.com/nodejs/node-gyp/issues/454)

To test your installation worked, type the flutter-view command in your Terminal or console:

> `>> flutter-view`
>
> `flutter-view - flutter template code generator`  \
> `Converts html and css templates into Flutter view widget code.`  \
> `Please pass a directory to scan.`  \
> `flutter-view -h for help.`

If you got the above text, your installation was successful.

## Installing flutter-view-widgets

Flutter-view has an optional Dart tooling library. It allows you to use the reactive, assign and life-cycle tags.

### Adding the dependency

To install it, add the following dependency to your project **pubspec.yaml** file:

> `flutter_view_widgets: ^2.2.4-dev.1`

*Important: the modern version of flutter-view is for Dart 2.13 and higher, and support type safety. If you have an older project, use the following:*

> `flutter_view_widgets: 1.0.6`

Then perform a flutter packages get to pull in the new dependency.

*Note: for the latest version, check the*[ *flutter-view-widgets pub page*](https://pub.dev/packages/flutter_view_widgets/versions)*.*

### Importing the tools

To import the library in Dart:

`import 'package:flutter_view_widgets/flutter_view_widgets.dart'`

To import the library in a Pug file:

`import(package='flutter_view_widgets/flutter_view_widgets.dart')`


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.flutter-view.io/get-started/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
