Skip to content

Commit

Permalink
Merge pull request #86 from Onix-Systems/dev
Browse files Browse the repository at this point in the history
feat(how_to): Added how to images
  • Loading branch information
Coloud1 authored Aug 6, 2024
2 parents a134ed1 + 429506c commit ab89eaa
Show file tree
Hide file tree
Showing 16 changed files with 60 additions and 35 deletions.
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,8 @@
<br/>
<br/>

If you're a Onix Project Generator user and you like using our tool, don't **forget to star it on GitHub**! 🌟

## What is Project Generator?

**Flutter Project Generator** is a utility for **MacOS** designed to quickly start a Flutter project from scratch.
Expand Down
2 changes: 1 addition & 1 deletion docs/CONTRIBUTE.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ Before fork this repository you need to know few important key points:

## Ways to contribute

* If you're a Onix Project Generator user and you like using our platform, don't **forget to star it on GitHub**! 🌟
* If you're a Onix Project Generator user and you like using our tool, don't **forget to star it on GitHub**! 🌟
* Improve the docs: Having good docs is key to a project's success. **You can make our docs the best** they need to be by **improving their quality or adding new ones**.
* We'd love to **hear your feedback**! We're always looking for ways to make Onix Project Generator better, so please **share how you use our application, what features you think we should add** via [GitHub](https://github.com/Onix-Systems/onix-flutter-project-generator/issues/new?assignees=&labels=enhancement&projects=&template=feature_request.md&title=).
* **Spread the word about the Onix Project Generator**. If you know anyone who might be interested, **please share the repository** with them. Thanks!
Expand Down
91 changes: 57 additions & 34 deletions docs/how_to/HOW_TO_CREATE_PROJECT.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,11 +13,8 @@ Onix Project Generator is built like the application creation wizard.

**Each section** of this document **represents a single step** in the application.

**Before create a new project make sure**:
* Flutter SDK and Dart are installed and visible in the terminal.


**Don’t like read too much**? Okay, **check the [video instruction](todo)** then.
**Before create a new project make sure that**
Flutter SDK and Dart are installed and visible in the terminal.


## Select project folder 📁
Expand All @@ -31,6 +28,11 @@ Select a desired **application mode**:
After you **select mode** you **need to choose the folder where the project will be located**.

<div align="center">
<img alt="refine logo" src="images/0_entry.png">
</div>


## Set the name

Enter the **name and organization** of your application.
Expand All @@ -54,17 +56,30 @@ Bundle ID: com.onix.my_app

> Note If you enable flavors your Package name and Bundle ID will have flavor name suffix also (except prod flavor).
<div align="center">
<img alt="refine logo" src="images/1_names.png">
</div>


**Once you are ready press on Continue button**.

## Select platforms 📱

Select platforms your project will support and **once you are ready press on Continue button**.

<div align="center">
<img alt="refine logo" src="images/2_platforms.png">
</div>


## Configure project options

Here you can configure the main options of the generated project.

<div align="center">
<img alt="refine logo" src="images/3_features.png">
</div>

### Flavorize

Enable or disable Flavors support.
Expand Down Expand Up @@ -136,10 +151,18 @@ After you press `Add screen` button you will see dialog:

**And once sreens added press on Continue button**.

<div align="center">
<img alt="refine logo" src="images/4_screens.png">
</div>

## Configure theme 🎨

Here you can import **colors and text styles from your Figma file**.

<div align="center">
<img alt="refine logo" src="images/5_styles.png">
</div>

To import you need:

* **Figma file key**.
Expand All @@ -162,6 +185,14 @@ After the token has created paste it in to Figma token input.
When you have pressed the import button you see colors and text style which will be imported to the project theme.

<div align="center">
<img alt="refine logo" src="images/6_styles_colors.png">
</div>

<div align="center">
<img alt="refine logo" src="images/7_styles_fonts.png">
</div>

**Once you finished press on Continue button**.

**Or just press Continue button with empty inputs to skip this step**.
Expand All @@ -178,6 +209,10 @@ https://petstore.swagger.io/v2/swagger.json

Paste your Swagger Json Url into the input field and press continue.

<div align="center">
<img alt="refine logo" src="images/8_swagger.png">
</div>

**Once parsing completed you will be redirected to the next screen**.

**Or just press Continue button with empty input value to skip this step**.
Expand All @@ -201,49 +236,33 @@ For each data component Onix Project Generator will create:
* **Entity** (with Freezed declaration)
* **Mapper** (from Data Model to Entity)


If something missing **you can add components and groups manually**.

To a add new group press the **Add source** button and enter the group name.

To add a component to the group press the **Add component button** at the group header.

In a dialog that will come up:

* **Enter Name**.
* **Select model types** to create.
* **Press Fields button** to add parameters to component.

In the field creation dialog you can add additional parameters to you data component.

Add primitive fields:

* Press **Add field** to add new parameter with primitive type
* Enter parameter name.
* Check is it list or nullable.


Add references:

* Press **Add component** to add reference to other component.
* **Select reference object** from dropdown and enter parameter name
* Check is it list or nullable.

**Once you finished press on Continue button**.

<div align="center">
<img alt="refine logo" src="images/9_components.png">
</div>

## Review a summary 👀

Here you can review all parameters and data will be generated.

**If looks good press on Generate project button**.

<div align="center">
<img alt="refine logo" src="images/10_summary.png">
</div>

## Build ⚡

Once you press the **Generate project** button you will see project generation progress in the improvised terminal window.

Generation process will be stopped if critical error occurs. You able to see all logs in terminal window.

Once Generation completed successfully **Open Android studio** button will appear.
Once Generation completed successfully **Open Android studio** button will appear.

<div align="center">
<img alt="refine logo" src="images/11_completed.png">
</div>

## What's Next? 🤔

Expand All @@ -255,6 +274,10 @@ Once the project opened:
* Run **Organize imports**.

**Done. You are ready for to develop**.

<div align="center">
<img alt="refine logo" src="images/12_project.png">
</div>


Have a question? Don't be shy to contact us via [GitHub](https://github.com/Onix-Systems/onix-flutter-project-generator/issues/new?assignees=&labels=question&projects=&template=question.md&title=Question%20about%20Onix%20Project%20Generator).
Binary file added docs/how_to/images/0_entry.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/how_to/images/10_summary.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/how_to/images/11_completed.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/how_to/images/12_project.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/how_to/images/1_names.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/how_to/images/2_platforms.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/how_to/images/3_features.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/how_to/images/4_screens.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/how_to/images/5_styles.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/how_to/images/6_styles_colors.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/how_to/images/7_styles_fonts.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/how_to/images/8_swagger.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/how_to/images/9_components.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit ab89eaa

Please sign in to comment.