Projects

In Fine, a Project is a repository, with added settings for the Dev Environment, scripts for the Preview Environment and instructions for the AI Agent.

If you’ve connected your GitHub (recommended), each Project is linked to a GitHub repository.

If you're using Fine to work on an existing codebase; build a new custom repository that isn't a webapp; or use your own template to start a project - this page explains important information to enable you to configure and run your project.

If you're using Fine to build a new app from scratch, just start a conversation with the Agent with no Project selected. A new one will be automatically created, with the correct Project Instructions, Scripts and Environment Variables. See the App Building section of the docs for more.

Adding Project Instructions

You can add custom instructions and guidelines for the agent to follow, using Project Instructions. These will be followed no matter which LLM you choose and no matter how you trigger the task (inside Fine or from an integrated platform).

How to Add Project Instructions

Head to projects in the main navigation on the left and click the gear icon on the bottom right corner of each Project. The Project Settings panel will open on the right of the page. Click Add Project Instructions, add your instructions and press save.

Use Project Instructions for:

• Coding style preferences and conventions
• External documentation and style guides

Adding Scripts

Scripts are commands (or sequences of commands) that automate tasks like installing dependencies, building code, or running your app. Fine includes three main types of scripts:

1. Install Script
   • Automatically installs the necessary libraries or packages your project needs to run.
   • For example, npm install or yarn install.
2. Run Script
   • Starts your application.
   • For example, npm run start or yarn run dev.
3. App Port
   • Defines which port your application listens on (e.g., 3000).

By having these scripts in place, Fine can seamlessly run the code generated for your project in the AI Sandbox.

How to add Preview Environment Scripts

Head to Projects via the main navigation and click the settings icon on the relevant project. Add all three scripts (Install, Run and Port). Click the Tick icon to save the scripts you’ve added.

You’ll need to have added the scripts to be able to run your code, however, if you’re already in the conversation without having added scripts to the Project, when you click Run the Project Settings panel will conveniently open for you to add the scripts without needing to navigate away.

Adding Environment Variables

Environment variables are name–value pairs that provide flexible configuration to your application. You should use Environment Variables for sensitive or environment-specific data, such as API keys or database URLs. You should not hardcode them in your source code.

Examples:

• API_KEY=123456ABCDEF
• PORT=3000
• DATABASE_URL=https://some-database.example.com

How to add Environment Variables

Like Scrips, Environment Variables in Fine are project-based. Head to Projects via the main navigation and click the settings icon on the relevant project. You’ll be able to add as many Environment Variables as you like.

Create a new project

Looking to start a new project in Fine without defaulting to the Agent's templates?

• Perhaps you'd like your code in another language
• Perhaps you only need a specific script
• Perhaps you have your own template

You'll need to create a New Project in the Projects page, add your own Project Instructions [if relevant] and then begin working with the Agent, just like working on an existing codebase.

1. Natigate to Projects
2. Click "Create Project"
3. Choose the name of the project, which will also be the name of the GitHub repo. This cannot include spaces.
4. Click Save & Push and you're good to go!