Skip to content
This repository has been archived by the owner on Jan 25, 2024. It is now read-only.

Commit

Permalink
Merge branch 'stable' into release/1.3.4
Browse files Browse the repository at this point in the history
  • Loading branch information
ivan-015 committed Feb 23, 2021
2 parents 98969a0 + c6c8cc8 commit 9ad6cc9
Show file tree
Hide file tree
Showing 2 changed files with 18 additions and 5 deletions.
20 changes: 18 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,19 @@ Parabeac-Core is an open-source repository that converts design files into Flutt
<a href="https://github.com/Parabeac/Parabeac-Core/wiki/Setting-up-a-debug-environment">Debugging</a>
</h3>

# Table of Contents
1. [What is Parabeac-Core](#what-is-parabeac-core)
2. [Get Started](#get-started)

1. [Cloning the Repo](#cloning-the-repo)
2. [Running the conversion](#running-the-conversion)
3. [Metrics](#metrics)
4. [Using State Management Configuration](#using-state-management-configuration)
3. [Running the exported Code](#running-the-exported-code)
4. [How to create & run Parabeac eggs](#how-to-create-&-run-parabeac-eggs)
5. [How it works](#how-it-works)
6. [How to contribute](#how-to-contribute)

# What is Parabeac-Core?
Parabeac-Core is an open-source repository that converts design files into Flutter code. The biggest challenge in code conversion is achieving quality code, but in a tool like this, there’s so much variability in what quality code should look like. So Parabeac-Core is built in a way not to promise quality code, but to be driven by the community so that you can configure & tweak to you or your teams liking. See our [Manifesto](https://github.com/Parabeac/Parabeac-Core/blob/stable/MANIFESTO.md). We welcome contributors to improve Parabeac-Core, create [Parabeac Eggs](https://github.com/Parabeac/parabeac-egg-template), & to join our [Discord](https://discord.com/invite/qUrghes) community!

Expand Down Expand Up @@ -102,6 +115,7 @@ Since Figma operates from a cloud native approach we use the Figma File ID and a

## Metrics
Parabeac-core keeps track of how many times it is run. Although we do not collect any personal information, you can turn off metrics at any time by creating the environment variable `PB_METRICS = "false"`.

## Using State Management Configuration
![State Management](https://kindling-sketch.s3.amazonaws.com/PB_to_Flutter_with_State_management.png)

Expand All @@ -121,9 +135,12 @@ To set the state management configuration, head over to edit `/Parabeac-Core/lib
}
```

Here you can replace the `state-management` property to `bloc` or `provider`. Soon you can also set `riverpod`.
Here you can replace the `state-management` property to `bloc`, `provider`, or `riverpod`.

For sample Sketch and Figma files you can use to test state management, please see [Get Started](#get-started)

You can learn how to easily create your own state management configuration in the [wiki](https://github.com/Parabeac/Parabeac-Core/wiki/How-to-Create-a-State-Management-Configuration), let us know if you're thinking about doing this and if you need any help!

# Running the exported code
### Requirements
- Flutter
Expand Down Expand Up @@ -178,7 +195,6 @@ Depending on the type of layout to add alignment to we have various services to

![Parabeac Alignment Generation Service Animation](https://kindling-sketch.s3.amazonaws.com/parabeac-alignment-generation-service2.gif)


# How to contribute
Welcome! The best way to contribute to Parabeac is through pull requests, filing issues on Github, writing documentation & helping others in our Discord community. We are an early project, but like many other projects, helping with bugs that others have filed on Stack Overflow is extremely helpful. We recommend filing bugs & feature requests on the Github issue tracker. For more details make sure to check out our [wiki](https://github.com/Parabeac/Parabeac-Core/wiki).

Expand Down
3 changes: 0 additions & 3 deletions package-lock.json

This file was deleted.

0 comments on commit 9ad6cc9

Please sign in to comment.