Update README file

Author: bllizard22

README.md

@@ -1,3 +1,22 @@
 # PaletteGenerator
+This tool helps:
+- Use Figma API to fetch [colors data](#Figma-API-fetcher)
+ > Styles library should be published to enable API usage
+- Rearrange it in case you have light/dark mode values
+- [Generate](#Swift-CodeGen) swift file from fetched data
 
-A description of this package.
+## Quick Start
+
+- Start with adding all required [values](tools/README.md)
+- Compile script with `./buildGenerator.sh`
+- Execute `./PaletteGenerator`
+
+## Figma API fetcher
+
+[Details here](tools/README.md)
+
+## Swift CodeGen
+This stage generates swift file with colors values enum using Stencil.
+It takes data from Figma API fetcher output JSON.
+
+You can check templates for generator [here](Project/Sources/PaletteGenerator/Stencils)

tools/README.md

@@ -1,7 +1,16 @@
+# Figma API fetcher
+
+## Values
+- `io_helpers.JSON_FILE_NAME` - name of output JSON file
+- `figma_api.FIGMA_FILE_NAME` - Figma file name. Can be obtained from https://www.figma.com/file/<FIGMA_FILE_NAME>/
+- `figma_api.FIGMA_TOKEN` - Figma API token. Can be obtained from https://www.figma.com/developers/api#access-tokens -> *+ Get personal access token*
+
+> Color token name structure is described [here](sources/token_name_parser.py) and can be updated for your needs
+
 ## Quick Start
 
-Script `colors_generator.py` will
-- Get list of styles from FIGMA SPECS
+Execute script `colors_generator.py`:
+- Get list of styles from your Figma file
 - Parse styles and convert them to JSON file using following format:
 
 Solid color:
@@ -43,8 +52,3 @@ Gradient color:
     }
 }
 ```
-
-## Values
-- `io_helpers.JSON_FILE_NAME` - name of output JSON file
-- `figma_api.FIGMA_FILE_NAME` - Figma file name. Can be obtained from https://www.figma.com/file/<FIGMA_FILE_NAME>/
-- `figma_api.FIGMA_TOKEN` - Figma API token. Can be obtained from https://www.figma.com/developers/api#access-tokens -> *+ Get personal access token*