Vibe Coding

FreeToken is tuned for vibe coding by providing AI development agents like Claude with context on how to use the SDK and its features. The SDK has a built in CLAUDE.md that agents look for when building apps with AI.

Getting Started

For best results, we recommend that you checkout the FreeToken SDK github repo to your computer.

Once it's checked out, start a new project in Xcode and add the FreeToken package as a dependency using Swift Package Manager. You can do this by going to File > Add Package Dependencies....

Then click Add Local... button at the botton and find the folder where you checked out the FreeToken repo. Select it and click Add Package.

Then select the target you want to add the package to and click Add Package. The target is usually the name of your app.

If this is your first time using FreeToken, please follow the Getting Started Guide to create your app and agent in the FreeToken console and configure the SDK.

Starting to Vibe

With Claude or other coding agents, we recommend that you add the local folder on your hard drive as context for the AI.

Claude Code

Use the /add-dir command to add the local folder to the conversation. This will give the agent access to all the files in the FreeToken repo including the CLAUDE.md file that describes how to use the SDK.

GitHub Copilot, Codex, & Others

The easiest way to provide the additional context is to make sure your project, and the FreeToken SDK are siblings in the same folder. For example:

/Development
   /FreeTokenSwift  <--- FreeToken SDK checked out from github
   /MyNewApp        <--- Your new app project

Then execute your AI in the /Development folder. This way the AI will have access to both your app and the FreeToken SDK.