# Adding the Clarion to an Existing Project
If you already have build pipeline for your front-end code, but want to take advantage of the Clarion Style Architecture or Framework, adding Clarion to your project is a cinch.
NOTE
If you don't have a build pipeline for your code, feel free to create an new project using the Clarion CLI and pull over what you would like.
# Adding Clarion Using the CLI
- In your terminal or command-line tool, navigate to the directory where you would like to add Clarion
NOTE
When using the Clarion CLI to add and remove files and directories, it will look in th /src
directory by default. If you add your styles to a different directory (another common place is the /assets
directory), you can configure Clarion to use a specified directory.
- Run the command
clarion new
- Select
Manual Configuration
- If you would like the Architecture and Style Framework select
Styles Only
, otherwise selectArchitecture Only
- Select the format you would like your styles to be in (for this demo I will choose
SCSS
)
You should now see a new directory based on your style format (in this case called /scss
).
# Adding You New Styles to your Build Pipeline
Different build tools handle preprocessors differently so make sure you consult the documentation on how to incorporate them into your build pipeline. If you are using a tool like webpack, incorporating them into your project may be as easy as adding importing the main manifest to your main script file (some additional set up may be required).
If you are using a framework like Vue.js or React, they have made it very simple to add a your styles to the project pipeline. Again, consult the documentation for additional information and support.
# Configuring Your Project for the Clarion CLI
NOTE
As stated above, if you added your styles to the /src
directory, you do not have to do this step.
For this example, let's say the the styles are in the /assets
directory. To up date the configuration:
- In your terminal or command-line tool navigate to the root of your project.
- Run the command
clarion config
- You will be prompted with
What is the path to your styles directory?
- Type
./assets
- Feel free to update the values with your project's configuration or just press enter to use the default values.
At the root of your project you should now see a new file named clarion-config.json
. The contents are fairly simple:
{
"paths": {
"styles": "./assets"
},
"format": {
"styles": "scss"
},
"addToManifest": true,
"importAbstracts": true
}
If you would like to manually update these values rather than using the CLI, you should be able to without any problems.
NOTE
For more information on configuring your project, check out the official documentation.