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

Commit

Permalink
Merge pull request #274 from Parabeac/hotfix/sm-readme-update
Browse files Browse the repository at this point in the history
Added table of contents to readme.
  • Loading branch information
mergify[bot] committed Feb 22, 2021
2 parents b7c0288 + 83dab0f commit c6c8cc8
Showing 1 changed file with 16 additions and 4 deletions.
20 changes: 16 additions & 4 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 @@ -100,7 +113,6 @@ Since Figma operates from a cloud native approach we use the Figma File ID and a
3. Scroll Down to the "Create a new Personal Access Token"
4. Create a new Personal Access Token with the name Parabeac, you should then be prompted with your new API Key. Make sure to copy this as you wont be able to access it again after you click confirm. (It should look something like this: ```64522-a0e5509a-d5ce-47a8-880b-c295f9cb27ed```


## 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"`.

Expand All @@ -123,11 +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`.

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!
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 @@ -182,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

0 comments on commit c6c8cc8

Please sign in to comment.