Skip to content

Commit ab89eaa

Browse files
authored
Merge pull request #86 from Onix-Systems/dev
feat(how_to): Added how to images
2 parents a134ed1 + 429506c commit ab89eaa

16 files changed

+60
-35
lines changed

README.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,8 @@
2929
<br/>
3030
<br/>
3131

32+
If you're a Onix Project Generator user and you like using our tool, don't **forget to star it on GitHub**! 🌟
33+
3234
## What is Project Generator?
3335

3436
**Flutter Project Generator** is a utility for **MacOS** designed to quickly start a Flutter project from scratch.

docs/CONTRIBUTE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ Before fork this repository you need to know few important key points:
2222

2323
## Ways to contribute
2424

25-
* If you're a Onix Project Generator user and you like using our platform, don't **forget to star it on GitHub**! 🌟
25+
* If you're a Onix Project Generator user and you like using our tool, don't **forget to star it on GitHub**! 🌟
2626
* 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**.
2727
* 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=).
2828
* **Spread the word about the Onix Project Generator**. If you know anyone who might be interested, **please share the repository** with them. Thanks!

docs/how_to/HOW_TO_CREATE_PROJECT.md

Lines changed: 57 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -13,11 +13,8 @@ Onix Project Generator is built like the application creation wizard.
1313

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

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

2219

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

31+
<div align="center">
32+
<img alt="refine logo" src="images/0_entry.png">
33+
</div>
34+
35+
3436
## Set the name
3537

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

5557
> Note If you enable flavors your Package name and Bundle ID will have flavor name suffix also (except prod flavor).
5658
59+
<div align="center">
60+
<img alt="refine logo" src="images/1_names.png">
61+
</div>
62+
63+
5764
**Once you are ready press on Continue button**.
5865

5966
## Select platforms 📱
6067

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

70+
<div align="center">
71+
<img alt="refine logo" src="images/2_platforms.png">
72+
</div>
73+
6374

6475
## Configure project options
6576

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

79+
<div align="center">
80+
<img alt="refine logo" src="images/3_features.png">
81+
</div>
82+
6883
### Flavorize
6984

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

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

154+
<div align="center">
155+
<img alt="refine logo" src="images/4_screens.png">
156+
</div>
157+
139158
## Configure theme 🎨
140159

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

162+
<div align="center">
163+
<img alt="refine logo" src="images/5_styles.png">
164+
</div>
165+
143166
To import you need:
144167

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

188+
<div align="center">
189+
<img alt="refine logo" src="images/6_styles_colors.png">
190+
</div>
191+
192+
<div align="center">
193+
<img alt="refine logo" src="images/7_styles_fonts.png">
194+
</div>
195+
165196
**Once you finished press on Continue button**.
166197

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

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

212+
<div align="center">
213+
<img alt="refine logo" src="images/8_swagger.png">
214+
</div>
215+
181216
**Once parsing completed you will be redirected to the next screen**.
182217

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

204-
205-
If something missing **you can add components and groups manually**.
206-
207-
To a add new group press the **Add source** button and enter the group name.
208-
209-
To add a component to the group press the **Add component button** at the group header.
210-
211-
In a dialog that will come up:
212-
213-
* **Enter Name**.
214-
* **Select model types** to create.
215-
* **Press Fields button** to add parameters to component.
216-
217-
In the field creation dialog you can add additional parameters to you data component.
218-
219-
Add primitive fields:
220-
221-
* Press **Add field** to add new parameter with primitive type
222-
* Enter parameter name.
223-
* Check is it list or nullable.
224-
225-
226-
Add references:
227-
228-
* Press **Add component** to add reference to other component.
229-
* **Select reference object** from dropdown and enter parameter name
230-
* Check is it list or nullable.
231-
232239
**Once you finished press on Continue button**.
233240

241+
<div align="center">
242+
<img alt="refine logo" src="images/9_components.png">
243+
</div>
244+
234245
## Review a summary 👀
235246

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

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

251+
<div align="center">
252+
<img alt="refine logo" src="images/10_summary.png">
253+
</div>
254+
240255
## Build ⚡
241256

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

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

246-
Once Generation completed successfully **Open Android studio** button will appear.
261+
Once Generation completed successfully **Open Android studio** button will appear.
262+
263+
<div align="center">
264+
<img alt="refine logo" src="images/11_completed.png">
265+
</div>
247266

248267
## What's Next? 🤔
249268

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

257276
**Done. You are ready for to develop**.
277+
278+
<div align="center">
279+
<img alt="refine logo" src="images/12_project.png">
280+
</div>
258281

259282

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

docs/how_to/images/0_entry.png

471 KB
Loading

docs/how_to/images/10_summary.png

447 KB
Loading
753 KB
Loading

docs/how_to/images/12_project.png

831 KB
Loading

docs/how_to/images/1_names.png

485 KB
Loading

docs/how_to/images/2_platforms.png

501 KB
Loading

docs/how_to/images/3_features.png

588 KB
Loading

0 commit comments

Comments
 (0)