diff --git a/docs/faststore/docs/reference/project-structure/overview.mdx b/docs/faststore/docs/reference/project-structure/overview.mdx index 57f4786911..3f322327e7 100644 --- a/docs/faststore/docs/reference/project-structure/overview.mdx +++ b/docs/faststore/docs/reference/project-structure/overview.mdx @@ -4,7 +4,7 @@ title: 'Understanding the Project Structure' In the previous guide of this track, you started your first FastStore project, learned how to run a local server, and made your first changes to the storefront. Now, it is time to understand how a FastStore project is structured. -By understanding the structure of a FastStore project, you can better navigate the codebase and make customizations to fit your specific needs. +Understanding the structure of a FastStore project can help you navigate the codebase and customize it to fit your specific needs. Let's start taking a look at the structure that represents the source code of a FastStore project: @@ -39,7 +39,7 @@ Let's start taking a look at the structure that represents the source code of a ## Files -- `custom-theme.scss` - Holds the styling information for your store, controlling the graphic elements such as typography, colors, borders, and spacing that provide your store with a unique look and feel. +- `custom-theme.scss` - Holds the styling information for your store, controlling the graphic elements such as typography, colors, borders, and spacing that give your store with a unique look and feel. - `cypress.config.ts` - Configures the options and preferences required for running tests with Cypress. @@ -50,7 +50,7 @@ For more information on configuration options for this file, refer to [Configura - `tsconfig.json` - Configures the compiler options and project settings for TypeScript, including target version, module resolution, and source file locations. -- `vtex.env` - Holds environment variables that your application can access during runtime, such as API keys and database credentials. +- `vtex.env` - Stores public environment variables that your application can access during runtime. These include flags like `SITE_HOST` (specifying the store's domain in production) and other publicly accessible values, including feature flags, URLs, and Analytics public tracking IDs. For private environment variables such as API keys and database credentials, use [VTEX secrets](https://v1.faststore.dev/how-to-guides/webops/security/setting-up-secrets). - `yarn.lock` - Locks down the exact versions of your project's dependencies, including transitive dependencies, to ensure consistent builds across different machines and environments. This file is automatically generated based on the dependencies in your `package.json` file. @@ -79,7 +79,7 @@ The SDKs also provide GA4-compatible analytics functions to help you create powe Gathers the design system based on FastStore components, using [Sass](https://sass-lang.com/) for styling. For more information, refer to the [FastStore UI](https://developers.vtex.com/docs/guides/faststore/components-index) guide. -> ℹ️ Although the components use [Sass](https://sass-lang.com/), you can work with the desired tool for styling. +> ℹ️ Although the components use [Sass](https://sass-lang.com/), you can style them using the desired tool for styling. #### `@faststore/api`