particular-cloud VS Code extension

Integrate Particular.Cloud into your development workflow. This extension allows you to create new i18n keys and autocomplete your existing keys fetched from your project. Hover over keys to see your text values, refactor text to i18n calls and push text to your Particular.Cloud project.

Documentation

Please find a more detailed documentation on particular.cloud/documentation/vscode

Features

• autocompletion
• key creation
• string refactoring
• t function call snippet
• useText hook snippet)

Authentification

We distinguish between read-only and write-access tokens. For development, you want to create a write-access token. Go to Particular.Cloud, navigate to your current project settings, and create a new write-access token. Find more information about token generation in our developer documentation.

Write-access tokens must not be shared. Never commit a write-access token to your public repository or use it in your application!

Create a .particularrc.json file in your project root folder:

in .particularrc.json

{
    "token": "particular.dev-[your-token-id]",
    "defaultLanguage": "en-US"
}

Now copy the write-access token from Particular.Cloud and add it to your .particularrc.json. file.

IMPORTANT ❗: Hide your secret write-access token by adding the following to your .gitignore file:

# hide write-access token
.particularrc.json

Extension Settings

No further configurations required.

Known Issues

Release Notes

0.4.0

Update of configuration schema

• Changes schema of .particularrc.json and package.json
• Improves error and warning messages
• Updates to latest i18n-js version

0.3.0

websocket migration

• Adds new LICENSE
• Replaces re-fresh on change with websocket connection (socket.io)

0.2.0

mdx support (test)

• Adds mdx refactoring and hover support
• Renaming snippets based on latest i18n-js changes

0.1.0

Beta release

• Adds hover provider
• Adds json validations

0.0.1

Initial release