fix: clarify organization_id and add import examples

README.md

@@ -44,6 +44,7 @@ import {
 }
 
 resource "supabase_project" "production" {
+  # organization_id is your organization slug (found in dashboard URL)
   organization_id   = "nknnyrtlhxudbsbuazsu"
   name              = "tf-project"
   database_password = "tf-example"

docs/resources/branch.md

@@ -49,3 +49,17 @@ Read-Only:
 - `status` (String) Status
 - `user` (String) User
 - `version` (String) Postgres version
+
+## Import
+
+Import is supported using the branch identifier.
+
+```shell
+terraform import supabase_branch.example <branch_id>
+```
+
+Example:
+
+```shell
+terraform import supabase_branch.development abc123def456
+```

docs/resources/project.md

@@ -36,7 +36,7 @@ resource "supabase_project" "test" {
 
 - `database_password` (String, Sensitive) Password for the project database
 - `name` (String) Name of the project
-- `organization_id` (String) Reference to the organization
+- `organization_id` (String) Organization slug (found in the Supabase dashboard URL or organization settings)
 - `region` (String) Region where the project is located
 
 ### Optional
@@ -46,3 +46,17 @@ resource "supabase_project" "test" {
 ### Read-Only
 
 - `id` (String) Project identifier
+
+## Import
+
+Import is supported using the project reference (ref). You can find your project ref in the project URL or settings.
+
+```shell
+terraform import supabase_project.example <project_ref>
+```
+
+Example:
+
+```shell
+terraform import supabase_project.production mayuaycdtijbctgqbycg
+```

docs/resources/settings.md

@@ -61,3 +61,17 @@ resource "supabase_settings" "production" {
 ### Read-Only
 
 - `id` (String) Project identifier
+
+## Import
+
+Import is supported using the project reference. When importing, all existing settings are fetched from the API, making it easy to selectively manage specific settings through Terraform.
+
+```shell
+terraform import supabase_settings.example <project_ref>
+```
+
+Example:
+
+```shell
+terraform import supabase_settings.production mayuaycdtijbctgqbycg
+```

docs/schema.json

@@ -148,7 +148,7 @@
               },
               "organization_id": {
                 "type": "string",
-                "description": "Reference to the organization",
+                "description": "Organization slug (found in the Supabase dashboard URL or organization settings)",
                 "description_kind": "markdown",
                 "required": true
               },

internal/provider/project_resource.go

@@ -52,7 +52,7 @@ func (r *ProjectResource) Schema(ctx context.Context, req resource.SchemaRequest
 
 		Attributes: map[string]schema.Attribute{
 			"organization_id": schema.StringAttribute{
-				MarkdownDescription: "Reference to the organization",
+				MarkdownDescription: "Organization slug (found in the Supabase dashboard URL or organization settings)",
 				Required:            true,
 			},
 			"name": schema.StringAttribute{

templates/resources/branch.md.tmpl

@@ -0,0 +1,31 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "{{.Name}} {{.Type}} - {{.RenderedProviderName}}"
+subcategory: ""
+description: |-
+{{ .Description | plainmarkdown | trimspace | prefixlines "  " }}
+---
+
+# {{.Name}} ({{.Type}})
+
+{{ .Description | trimspace }}
+
+## Example Usage
+
+{{ tffile "examples/resources/supabase_branch/resource.tf" }}
+
+{{ .SchemaMarkdown | trimspace }}
+
+## Import
+
+Import is supported using the branch identifier.
+
+```shell
+terraform import supabase_branch.example <branch_id>
+```
+
+Example:
+
+```shell
+terraform import supabase_branch.development abc123def456
+```

templates/resources/project.md.tmpl

@@ -0,0 +1,31 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "{{.Name}} {{.Type}} - {{.RenderedProviderName}}"
+subcategory: ""
+description: |-
+{{ .Description | plainmarkdown | trimspace | prefixlines "  " }}
+---
+
+# {{.Name}} ({{.Type}})
+
+{{ .Description | trimspace }}
+
+## Example Usage
+
+{{ tffile "examples/resources/supabase_project/resource.tf" }}
+
+{{ .SchemaMarkdown | trimspace }}
+
+## Import
+
+Import is supported using the project reference (ref). You can find your project ref in the project URL or settings.
+
+```shell
+terraform import supabase_project.example <project_ref>
+```
+
+Example:
+
+```shell
+terraform import supabase_project.production mayuaycdtijbctgqbycg
+```

templates/resources/settings.md.tmpl

@@ -0,0 +1,31 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "{{.Name}} {{.Type}} - {{.RenderedProviderName}}"
+subcategory: ""
+description: |-
+{{ .Description | plainmarkdown | trimspace | prefixlines "  " }}
+---
+
+# {{.Name}} ({{.Type}})
+
+{{ .Description | trimspace }}
+
+## Example Usage
+
+{{ tffile "examples/resources/supabase_settings/resource.tf" }}
+
+{{ .SchemaMarkdown | trimspace }}
+
+## Import
+
+Import is supported using the project reference. When importing, all existing settings are fetched from the API, making it easy to selectively manage specific settings through Terraform.
+
+```shell
+terraform import supabase_settings.example <project_ref>
+```
+
+Example:
+
+```shell
+terraform import supabase_settings.production mayuaycdtijbctgqbycg
+```