Dyad LogoDyad

Importing app

If you have an existing app that you want to bring into Dyad

Importing apps is experimental as of v0.6.0. Please report bugs.

If you’ve built your app using tools like Lovable, V0, Bolt, or anything else, you can now bring it into Dyad.

AI Rules

Dyad relies on a file called AI_RULES.md in the root of your project. This file contains AI rules — instructions that guide Dyad as it edits your app. It should describe your app’s tech stack and architecture so Dyad can make informed, meaningful changes.

If your project doesn’t already have an AI_RULES.md file, Dyad will automatically generate one when you import the app.

Limitations

Since app importing is still experimental, there are a few important limitations to keep in mind:

JavaScript apps only

Dyad currently only supports Node.js-based JavaScript apps. You can’t import apps built with non-JavaScript frameworks like Laravel (PHP) or Ruby on Rails.

npm run dev required

Dyad runs npm run dev by default to start the local development server. If your app doesn't include a dev script, you’ll need to add one in package.json.

Most modern JavaScript frameworks (e.g. Vite, Next.js) already follow this convention, so it shouldn’t be an issue in most cases.

On this page