{"name":"Projects App Guide Answer Index","url":"https://projectsappguide.com/answers","generatedFrom":"https://projectsappguide.com/sitemap.xml","disclaimer":"Independent educational guide. Not affiliated with, endorsed by, or sponsored by HubSpot. Verify critical commands and platform behavior against official HubSpot documentation before deploying.","keyBoundary":"The May 26 and June 23, 2026 dates discussed here affect new legacy public app creation through the legacy Developer Platform UI. They should not be described as existing legacy public app shutdown dates under that specific sunset.","pages":[{"title":"HubSpot Legacy Public App Creation Sunset: May 26 and June 23, 2026","url":"https://projectsappguide.com/hubspot-legacy-public-app-creation-sunset","intent":"Understand the deadline and avoid overreacting.","lastSourceCheck":"2026-05-24","summary":"The May/June sunset disables new legacy public app creation in the legacy UI. It does not mean existing legacy public apps stop functioning under this specific event.","answerSnapshot":{"shortAnswer":"The May 26 and June 23, 2026 HubSpot dates affect new legacy public app creation through the legacy Developer Platform UI, not existing legacy public app runtime under this specific sunset.","appliesTo":"Developer teams planning to create a new public or Marketplace app after the relevant account-date cutoff.","verify":"Open HubSpot's legacy public app creation sunset changelog and the Projects CLI create-app docs before choosing a path.","boundary":"Do not describe these dates as an existing legacy public app shutdown notice."},"claims":[{"claim":"May 26, 2026 affects new developer accounts created on or after that date.","source":{"label":"Legacy Public App Creation Sunset","url":"https://developers.hubspot.com/changelog/legacy-public-app-creation-sunset"}},{"claim":"June 23, 2026 affects developer accounts created before May 26, 2026.","source":{"label":"Legacy Public App Creation Sunset","url":"https://developers.hubspot.com/changelog/legacy-public-app-creation-sunset"}},{"claim":"The safer next step for new public app creation is to review the Projects-based CLI app creation path.","source":{"label":"Create a new app using the CLI","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app"}}],"officialSources":[{"label":"Legacy Public App Creation Sunset","url":"https://developers.hubspot.com/changelog/legacy-public-app-creation-sunset"},{"label":"Create a new app using the CLI","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app"}],"faq":[{"question":"Do existing legacy public apps stop working on May 26 or June 23, 2026?","answer":"No. This specific sunset affects new legacy public app creation through the legacy Developer Platform UI. It should not be described as a shutdown date for existing legacy public apps."},{"question":"Who should care about the May and June 2026 dates?","answer":"Teams that need to create a new public or Marketplace app through the legacy UI after the relevant account-date cutoff should review the Projects-based CLI app creation path."},{"question":"What is the safest next step?","answer":"Classify the app state, record whether the work is new app creation or modernization, then open the current HubSpot changelog and Projects CLI docs before choosing a command path."}],"naturalLanguageQuestions":["HubSpot Legacy Public App Creation Sunset: May 26 and June 23, 2026","Do existing legacy public apps stop working on May 26 or June 23, 2026?","Who should care about the May and June 2026 dates?","What is the safest next step?"]},{"title":"HubSpot Projects CLI Checklist","url":"https://projectsappguide.com/hubspot-projects-cli-checklist","intent":"Run a preflight before creating or migrating an app.","lastSourceCheck":"2026-05-24","summary":"Use this checklist to classify the app, verify local environment, inspect project files, and choose a command path to verify in official docs.","answerSnapshot":{"shortAnswer":"Before running HubSpot Projects CLI commands, classify the app, inspect project files, record environment details, and identify the official command path to verify.","appliesTo":"Developers and agencies preparing new app creation, migration planning, Marketplace readiness, or CI upload workflows.","verify":"Check current HubSpot CLI create-app, project command, migration, and Marketplace listing docs before production-affecting work.","boundary":"This checklist is a planning and handoff aid, not an official HubSpot migration instruction or approval guarantee."},"claims":[{"claim":"New app creation, public app migration, project migration, private app planning, and CRM card modernization should be classified separately.","source":{"label":"Determine your migration path to 2026.03","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/migrate-an-app/overview"}},{"claim":"`hs project create`, project upload, and project open commands should be checked against current project command documentation.","source":{"label":"HubSpot CLI project commands","url":"https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands"}},{"claim":"Marketplace readiness needs listing and review materials beyond project file readiness.","source":{"label":"Listing your app","url":"https://developers.hubspot.com/docs/apps/developer-platform/list-apps/listing-your-app/listing-your-app"}}],"officialSources":[{"label":"Create a new app using the CLI","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app"},{"label":"HubSpot CLI project commands","url":"https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands"},{"label":"Determine your migration path to 2026.03","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/migrate-an-app/overview"},{"label":"Listing your app","url":"https://developers.hubspot.com/docs/apps/developer-platform/list-apps/listing-your-app/listing-your-app"}],"faq":[{"question":"What should I check before running a HubSpot Projects CLI command?","answer":"Classify the app first, then record CLI version, Node version, authenticated account, project files, platform version, app configuration, scopes, redirect URLs, and source-check date."},{"question":"Can this checklist replace HubSpot documentation?","answer":"No. It is an independent planning checklist. Production-affecting commands, uploads, submissions, and client handoffs should be verified against current official HubSpot documentation."},{"question":"What does the paid bundle add?","answer":"The bundle packages the checklist into reusable buyer files, including a command cheatsheet, CSV inventory tracker, developer handoff template, agent skill folder, and source map."}],"naturalLanguageQuestions":["HubSpot Projects CLI Checklist","What should I check before running a HubSpot Projects CLI command?","Can this checklist replace HubSpot documentation?","What does the paid bundle add?"]},{"title":"Use hs project create for a New HubSpot Marketplace App","url":"https://projectsappguide.com/hs-project-create-marketplace-app","intent":"Create a new app with the Projects-based workflow.","lastSourceCheck":"2026-05-24","summary":"HubSpot's create-app docs describe new developer platform apps as initialized using the HubSpot CLI, with `hs project create` as the setup command to review.","answerSnapshot":{"shortAnswer":"`hs project create` is the Projects CLI path to review when creating a new HubSpot developer platform app.","appliesTo":"Teams creating a new public or Marketplace app rather than modernizing an existing app.","verify":"Open the create-app docs, project commands docs, and Marketplace listing docs before upload or submission.","boundary":"Do not use new app creation guidance as a substitute for an existing app migration plan."},"claims":[{"claim":"New developer platform apps are created through the HubSpot CLI workflow.","source":{"label":"Create a new app using the CLI","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app"}},{"claim":"`hs project create` is a project command to verify for new app creation.","source":{"label":"HubSpot CLI project commands","url":"https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands"}},{"claim":"Marketplace submission has separate listing requirements and review materials.","source":{"label":"Listing your app","url":"https://developers.hubspot.com/docs/apps/developer-platform/list-apps/listing-your-app/listing-your-app"}}],"officialSources":[{"label":"Create a new app using the CLI","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app"},{"label":"HubSpot CLI project commands","url":"https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands"},{"label":"Listing your app","url":"https://developers.hubspot.com/docs/apps/developer-platform/list-apps/listing-your-app/listing-your-app"}],"faq":[{"question":"When should I use hs project create?","answer":"Use it as the official path to review when creating a new Projects-based app. Do not use it as a substitute for planning an existing app migration."},{"question":"Is a Marketplace app automatically ready after project creation?","answer":"No. Marketplace readiness also requires support, privacy, testing, install-flow, listing, and review materials checked against current HubSpot requirements."}],"naturalLanguageQuestions":["Use hs project create for a New HubSpot Marketplace App","When should I use hs project create?","Is a Marketplace app automatically ready after project creation?"]},{"title":"Legacy Public App vs Projects App","url":"https://projectsappguide.com/hubspot-legacy-public-app-vs-projects-app","intent":"Decide whether this is a creation issue or a modernization issue.","lastSourceCheck":"2026-05-24","summary":"The sunset is about creating new legacy public apps. Projects-based apps are the path HubSpot directs new public app development toward.","answerSnapshot":{"shortAnswer":"The key distinction is creation versus modernization: the May/June 2026 sunset affects new legacy public app creation, while migration decisions depend on the existing app state.","appliesTo":"Stakeholders deciding whether a HubSpot app needs new app creation, modernization, migration planning, or a separate card workstream.","verify":"Compare the sunset changelog with the create-app and migration overview docs before telling a client what changed.","boundary":"Do not collapse all older HubSpot app work into one migration deadline."},"claims":[{"claim":"The legacy public app sunset concerns new legacy public app creation.","source":{"label":"Legacy Public App Creation Sunset","url":"https://developers.hubspot.com/changelog/legacy-public-app-creation-sunset"}},{"claim":"New Projects-based app development should be reviewed from the create-app docs.","source":{"label":"Create a new app using the CLI","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app"}},{"claim":"Existing app migration paths should be evaluated from migration documentation.","source":{"label":"Determine your migration path to 2026.03","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/migrate-an-app/overview"}}],"officialSources":[{"label":"Legacy Public App Creation Sunset","url":"https://developers.hubspot.com/changelog/legacy-public-app-creation-sunset"},{"label":"Create a new app using the CLI","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app"},{"label":"Determine your migration path to 2026.03","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/migrate-an-app/overview"}],"faq":[{"question":"Is the legacy public app sunset the same as a migration deadline?","answer":"No. The May and June 2026 sunset affects new legacy public app creation. Migration and platform-version work should be evaluated from the relevant migration sources."},{"question":"How do I explain the difference to a client?","answer":"Separate new app creation, existing app modernization, Marketplace readiness, and CRM card modernization as different workstreams with different official sources."}],"naturalLanguageQuestions":["Legacy Public App vs Projects App","Is the legacy public app sunset the same as a migration deadline?","How do I explain the difference to a client?"]},{"title":"hs app migrate vs hs project migrate","url":"https://projectsappguide.com/hs-app-migrate-vs-hs-project-migrate","intent":"Choose the likely migration command path.","lastSourceCheck":"2026-05-24","summary":"Use app structure and platform version to decide which path to verify. Non-project legacy public app, existing project app, and private app cases should not be collapsed into one generic migration step.","answerSnapshot":{"shortAnswer":"Choose between `hs app migrate` and `hs project migrate` only after inspecting whether the app is non-project legacy, already project-based, public, private, and which platform version it uses.","appliesTo":"Developers with an existing HubSpot app who need to identify the likely migration command path to verify.","verify":"Open the migration overview, public app migration, latest-platform migration, and project command docs before running a command.","boundary":"Treat commands as paths to verify, not commands to run from memory."},"claims":[{"claim":"`hs app migrate` belongs to public app migration guidance, not new app creation.","source":{"label":"Migrate an existing public app","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/migrate-an-app/migrate-an-existing-public-app"}},{"claim":"`hs project migrate` and platform-version decisions should be checked against migration and project command docs.","source":{"label":"Migrate an existing app to 2026.03","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/migrate-an-app/migrate-to-the-latest-platform-version"}},{"claim":"The migration path depends on app state and current project structure.","source":{"label":"Determine your migration path to 2026.03","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/migrate-an-app/overview"}}],"officialSources":[{"label":"Determine your migration path to 2026.03","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/migrate-an-app/overview"},{"label":"Migrate an existing public app","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/migrate-an-app/migrate-an-existing-public-app"},{"label":"Migrate an existing app to 2026.03","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/migrate-an-app/migrate-to-the-latest-platform-version"},{"label":"HubSpot CLI project commands","url":"https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands"}],"faq":[{"question":"How do I choose between hs app migrate and hs project migrate?","answer":"Inspect the repo and app state first. Existing non-project legacy public apps, already project-based apps, and private apps point to different official migration guidance."},{"question":"Should I run a migration command immediately?","answer":"No. Treat the command as a path to verify after app classification, file inspection, install-risk review, and a current official source check."}],"naturalLanguageQuestions":["hs app migrate vs hs project migrate","How do I choose between hs app migrate and hs project migrate?","Should I run a migration command immediately?"]},{"title":"HubSpot Private App Projects Migration","url":"https://projectsappguide.com/hubspot-private-app-projects-migration","intent":"Avoid choosing an unsupported automatic path.","lastSourceCheck":"2026-05-24","summary":"Private app cases require special care. The latest-platform migration docs warn that migrating a legacy non-project-based private app to 2026.03 is not currently supported.","answerSnapshot":{"shortAnswer":"Private app migration should be treated as source-checked planning; do not assume every private app has an automatic Projects CLI migration path.","appliesTo":"Teams reviewing existing private apps, especially legacy non-project-based private apps.","verify":"Open current private app migration and latest-platform migration docs before proposing a command or replacement path.","boundary":"Do not promise automatic private app migration, compatibility, or official approval."},"claims":[{"claim":"Private app migration has separate guidance from public app migration.","source":{"label":"Migrate an existing private app","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/migrate-an-app/migrate-an-existing-private-app"}},{"claim":"Legacy non-project-based private app migration to 2026.03 has documented limitations.","source":{"label":"Migrate an existing app to 2026.03","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/migrate-an-app/migrate-to-the-latest-platform-version"}},{"claim":"Private app work may require manual planning depending on current app state and features.","source":{"label":"Determine your migration path to 2026.03","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/migrate-an-app/overview"}}],"officialSources":[{"label":"Migrate an existing private app","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/migrate-an-app/migrate-an-existing-private-app"},{"label":"Migrate an existing app to 2026.03","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/migrate-an-app/migrate-to-the-latest-platform-version"},{"label":"Determine your migration path to 2026.03","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/migrate-an-app/overview"}],"faq":[{"question":"Can every private app be migrated automatically?","answer":"No. Private app cases need careful source-checked planning, and documented limitations may apply depending on the app state and target platform version."},{"question":"What should a private app handoff include?","answer":"Include auth model, token handling, backend services, webhooks, UI extensions, serverless functions, CRM cards, current app state, and current source links."}],"naturalLanguageQuestions":["HubSpot Private App Projects Migration","Can every private app be migrated automatically?","What should a private app handoff include?"]},{"title":"HubSpot Developer Platform 2026.03 Upgrade","url":"https://projectsappguide.com/hubspot-developer-platform-2026-03-upgrade","intent":"Plan version upgrade.","lastSourceCheck":"2026-05-24","summary":"The 2026.03 platform version is central to current migration docs. Check `hsproject.json`, current `platformVersion`, and supported migration path before making changes.","answerSnapshot":{"shortAnswer":"A 2026.03 upgrade starts with `hsproject.json`, current `platformVersion`, app type, and the supported migration path in current HubSpot docs.","appliesTo":"Teams maintaining existing project-based apps or evaluating migration to the latest HubSpot developer platform version.","verify":"Open the migration overview, latest-platform migration, and project command docs before changing platformVersion or uploading.","boundary":"Do not treat 2026.03 platform work as the same event as the May/June legacy public app creation sunset."},"claims":[{"claim":"`platformVersion` should be inspected in the project configuration before upgrade planning.","source":{"label":"Determine your migration path to 2026.03","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/migrate-an-app/overview"}},{"claim":"Latest-platform migration guidance includes cases and limitations that should be checked before changes.","source":{"label":"Migrate an existing app to 2026.03","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/migrate-an-app/migrate-to-the-latest-platform-version"}},{"claim":"Project command behavior should be checked against current CLI project command docs.","source":{"label":"HubSpot CLI project commands","url":"https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands"}}],"officialSources":[{"label":"Determine your migration path to 2026.03","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/migrate-an-app/overview"},{"label":"Migrate an existing app to 2026.03","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/migrate-an-app/migrate-to-the-latest-platform-version"},{"label":"HubSpot CLI project commands","url":"https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands"}],"faq":[{"question":"Is platformVersion 2026.03 the same as the May/June creation sunset?","answer":"No. Platform-version migration is a separate workstream from the legacy public app creation sunset."},{"question":"What file should I inspect first for platform version?","answer":"Start with `hsproject.json`, then review app type, feature files, serverless functions, app cards, and current migration docs before changing files."}],"naturalLanguageQuestions":["HubSpot Developer Platform 2026.03 Upgrade","Is platformVersion 2026.03 the same as the May/June creation sunset?","What file should I inspect first for platform version?"]},{"title":"HubSpot app-hsmeta.json Structure Checklist","url":"https://projectsappguide.com/hubspot-app-hsmeta-json-structure","intent":"Troubleshoot project structure.","lastSourceCheck":"2026-05-24","summary":"`app-hsmeta.json` is a key app schema file in Projects-based app workflows. Its location and fields should be checked before upload or migration.","answerSnapshot":{"shortAnswer":"`app-hsmeta.json` should be reviewed with the full HubSpot project structure before upload, migration, or install-flow testing.","appliesTo":"Developers troubleshooting Projects-based app structure, identifiers, auth settings, redirect URLs, scopes, and upload readiness.","verify":"Open create-app, project command, and relevant migration docs before changing app identifiers or auth configuration.","boundary":"A valid-looking app file does not prove Marketplace readiness or official approval."},"claims":[{"claim":"Projects-based app configuration should be reviewed in the context of the project structure.","source":{"label":"Create a new app using the CLI","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app"}},{"claim":"Private app cases can have migration limitations and should not be inferred from public app examples.","source":{"label":"Migrate an existing private app","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/migrate-an-app/migrate-an-existing-private-app"}},{"claim":"Upload and local project commands should be verified from current project command docs.","source":{"label":"HubSpot CLI project commands","url":"https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands"}}],"officialSources":[{"label":"Create a new app using the CLI","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app"},{"label":"Migrate an existing private app","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/migrate-an-app/migrate-an-existing-private-app"},{"label":"HubSpot CLI project commands","url":"https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands"}],"faq":[{"question":"What is app-hsmeta.json used for?","answer":"It is a key Projects-based app configuration file. Review it with the rest of the project structure rather than treating it as an isolated JSON snippet."},{"question":"Does a valid-looking app-hsmeta.json prove Marketplace readiness?","answer":"No. Marketplace readiness, install behavior, support materials, privacy materials, and review requirements still need separate verification."}],"naturalLanguageQuestions":["HubSpot app-hsmeta.json Structure Checklist","What is app-hsmeta.json used for?","Does a valid-looking app-hsmeta.json prove Marketplace readiness?"]},{"title":"HubSpot CLI, Node, and CI Preflight Checklist","url":"https://projectsappguide.com/hubspot-cli-node-ci-preflight","intent":"Prevent environment and CI issues.","lastSourceCheck":"2026-05-24","summary":"Before a Projects CLI migration or upload, record CLI version, Node version, account auth, and CI secret handling. Recheck the current CLI reference before changing pipelines.","answerSnapshot":{"shortAnswer":"A HubSpot CLI CI preflight should record versions, target account strategy, secret handling, selected command path, and source-check date before upload automation.","appliesTo":"Teams adding HubSpot Projects CLI upload or migration steps to local development and CI/CD workflows.","verify":"Open the current CLI reference and project command docs before changing pipeline behavior.","boundary":"Do not expose HubSpot tokens, client secrets, private keys, or account credentials in logs or prompts."},"claims":[{"claim":"CLI behavior should be checked against the current HubSpot CLI reference.","source":{"label":"HubSpot CLI reference","url":"https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/reference"}},{"claim":"Project commands should be checked before CI upload automation is enabled.","source":{"label":"HubSpot CLI project commands","url":"https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands"}}],"officialSources":[{"label":"HubSpot CLI reference","url":"https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/reference"},{"label":"HubSpot CLI project commands","url":"https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands"}],"faq":[{"question":"What should CI record before HubSpot CLI uploads?","answer":"Record CLI version, Node version, target account strategy, secret storage, selected command path, and a current source-check date."},{"question":"Should CI logs include HubSpot secrets?","answer":"No. Do not paste tokens, client secrets, private keys, or account credentials into docs, tickets, logs, or agent prompts."}],"naturalLanguageQuestions":["HubSpot CLI, Node, and CI Preflight Checklist","What should CI record before HubSpot CLI uploads?","Should CI logs include HubSpot secrets?"]},{"title":"Legacy CRM Cards to App Cards: October 31, 2026 Planning","url":"https://projectsappguide.com/hubspot-legacy-crm-cards-to-app-cards","intent":"Plan adjacent app-card modernization deadline.","lastSourceCheck":"2026-05-24","summary":"Classic/legacy CRM cards have a separate October 31, 2026 migration deadline. Do not mix this deadline with the May/June public app creation sunset.","answerSnapshot":{"shortAnswer":"Legacy or classic CRM card modernization is a separate app-card workstream and should not be merged with the May/June legacy public app creation sunset.","appliesTo":"Apps using classic or legacy CRM cards that need app-card modernization planning.","verify":"Open HubSpot CRM card docs and the classic CRM card deprecation changelog before planning card replacement.","boundary":"Use October 31, 2026 for CRM card modernization only, not for the public app creation sunset."},"claims":[{"claim":"Legacy or classic CRM card work has separate official guidance from public app creation.","source":{"label":"Legacy CRM cards guide","url":"https://developers.hubspot.com/docs/api-reference/crm-public-app-crm-cards-v3/guide"}},{"claim":"The October 31, 2026 date belongs to the classic CRM cards deprecation workstream.","source":{"label":"Classic CRM cards deprecation changelog","url":"https://developers.hubspot.com/changelog/deprecating-support-for-classic-crm-cards"}}],"officialSources":[{"label":"Legacy CRM cards guide","url":"https://developers.hubspot.com/docs/api-reference/crm-public-app-crm-cards-v3/guide"},{"label":"Classic CRM cards deprecation changelog","url":"https://developers.hubspot.com/changelog/deprecating-support-for-classic-crm-cards"}],"faq":[{"question":"Is the CRM card deadline part of the May/June public app creation sunset?","answer":"No. CRM card modernization is a separate app-card workstream with its own official sources and planning deadline."},{"question":"What should I inventory for CRM card modernization?","answer":"List each legacy or classic CRM card, object location, data source, UI behavior, scopes, backend owner, and test plan."}],"naturalLanguageQuestions":["Legacy CRM Cards to App Cards: October 31, 2026 Planning","Is the CRM card deadline part of the May/June public app creation sunset?","What should I inventory for CRM card modernization?"]},{"title":"HubSpot Marketplace Listing Checklist 2026","url":"https://projectsappguide.com/hubspot-marketplace-listing-checklist-2026","intent":"Prepare listing submission.","lastSourceCheck":"2026-05-24","summary":"Projects CLI readiness is not the same as Marketplace readiness. Prepare listing fields, support details, privacy URL, testing instructions, and install flow evidence.","answerSnapshot":{"shortAnswer":"Marketplace readiness is separate from Projects CLI readiness; a structured project still needs listing, support, privacy, testing, and install-flow evidence.","appliesTo":"Teams preparing a HubSpot public or Marketplace app for review or client handoff.","verify":"Open current HubSpot listing and Marketplace listing requirements before submission.","boundary":"No independent checklist can guarantee Marketplace approval."},"claims":[{"claim":"Marketplace listing requires its own submission and listing preparation work.","source":{"label":"Listing your app","url":"https://developers.hubspot.com/docs/apps/developer-platform/list-apps/listing-your-app/listing-your-app"}},{"claim":"Marketplace listing requirements should be checked before submission.","source":{"label":"App Marketplace listing requirements","url":"https://developers.hubspot.com/docs/api/app-marketplace-listing-requirements"}}],"officialSources":[{"label":"Listing your app","url":"https://developers.hubspot.com/docs/apps/developer-platform/list-apps/listing-your-app/listing-your-app"},{"label":"App Marketplace listing requirements","url":"https://developers.hubspot.com/docs/api/app-marketplace-listing-requirements"}],"faq":[{"question":"Does Projects CLI readiness guarantee Marketplace approval?","answer":"No. A project can be technically organized and still need listing, support, privacy, testing, install-flow, and review materials."},{"question":"What should agencies prepare before submission?","answer":"Prepare a reusable packet with app inventory, source-check date, support/privacy owners, testing instructions, screenshots/assets status, and current official listing requirements."}],"naturalLanguageQuestions":["HubSpot Marketplace Listing Checklist 2026","Does Projects CLI readiness guarantee Marketplace approval?","What should agencies prepare before submission?"]},{"title":"HubSpot hs project upload Checklist","url":"https://projectsappguide.com/hubspot-project-upload-checklist","intent":"Prepare a safer project upload.","lastSourceCheck":"2026-05-24","summary":"`hs project upload` uploads a HubSpot project and creates a build. Teams should verify account targeting, auto-deploy behavior, UID stability, auth configuration, and Marketplace implications before using it for meaningful changes.","answerSnapshot":{"shortAnswer":"`hs project upload` uploads the current project to HubSpot and creates a build; if auto-deploy is enabled, a successful build may deploy automatically.","appliesTo":"Developers moving a Projects-based HubSpot app from local work toward a sandbox, test account, or main account upload.","verify":"Open the current HubSpot CLI project commands docs and create-app docs before uploading to a production-affecting account.","boundary":"This checklist does not guarantee a successful build, deployment, install flow, or Marketplace review."},"claims":[{"claim":"`hs project upload` uploads a project to HubSpot and creates a build.","source":{"label":"HubSpot CLI project commands","url":"https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands"}},{"claim":"A project configured to auto-deploy can deploy automatically after a successful build, and new projects are documented as auto-deploy by default.","source":{"label":"HubSpot CLI project commands","url":"https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands"}},{"claim":"Changing component UIDs after upload can cause HubSpot to recognize a component as different from previous builds.","source":{"label":"Create a new app using the CLI","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app"}}],"officialSources":[{"label":"HubSpot CLI project commands","url":"https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands"},{"label":"Create a new app using the CLI","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app"},{"label":"App Marketplace listing requirements","url":"https://developers.hubspot.com/docs/api/app-marketplace-listing-requirements"}],"faq":[{"question":"Does hs project upload deploy automatically?","answer":"It can, depending on project auto-deploy settings. HubSpot's project command docs say an auto-deploy project deploys after a successful build, and new projects are documented as auto-deploy by default."},{"question":"How do I avoid uploading to the wrong HubSpot account?","answer":"Record the intended account before upload and review HubSpot's documented `--account=accountName` option for targeting a specific account from your CLI config."},{"question":"Should I change UIDs before upload?","answer":"Only with deliberate review. HubSpot's create-app docs note that changing a UID after upload may make the platform recognize the component as different from previous builds."}],"naturalLanguageQuestions":["HubSpot hs project upload Checklist","Does hs project upload deploy automatically?","How do I avoid uploading to the wrong HubSpot account?","Should I change UIDs before upload?"]},{"title":"HubSpot hs project dev Local Development Guide","url":"https://projectsappguide.com/hubspot-project-dev-local-development","intent":"Use local development without overtrusting it.","lastSourceCheck":"2026-05-24","summary":"`hs project dev` starts a local development server for supported HubSpot project extension work. It can refresh supported JSX UI changes, but JSON config changes still need manual upload.","answerSnapshot":{"shortAnswer":"`hs project dev` starts a local development server; supported JSX changes can refresh in the browser, while `.json` config changes need `hs project upload`.","appliesTo":"Developers building or testing HubSpot app cards, settings pages, and other Projects-based app work locally.","verify":"Open the current HubSpot project commands docs and create-app docs before relying on local development behavior.","boundary":"Local development preview is not production validation, Marketplace approval, or proof that all app configuration is uploaded."},"claims":[{"claim":"`hs project dev` starts a local development server for project work.","source":{"label":"HubSpot CLI project commands","url":"https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands"}},{"claim":"Supported JSX changes for app cards or settings pages can refresh while the server is running.","source":{"label":"HubSpot CLI project commands","url":"https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands"}},{"claim":"Changes to `.json` configuration files need manual upload with `hs project upload`.","source":{"label":"HubSpot CLI project commands","url":"https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands"}}],"officialSources":[{"label":"HubSpot CLI project commands","url":"https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands"},{"label":"Create a new app using the CLI","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app"}],"faq":[{"question":"What changes refresh in hs project dev?","answer":"HubSpot's project command docs call out supported JSX changes for app cards or settings pages using UI components while the local development server is running."},{"question":"Do JSON config files update automatically in local development?","answer":"No. The project command docs state that `.json` config file changes need to be manually uploaded using `hs project upload`."},{"question":"Is hs project watch still the recommended local loop?","answer":"The archived HubSpot project commands docs mark `hs project watch` as deprecated in favor of `hs project dev`; verify the current docs before using older workflows."}],"naturalLanguageQuestions":["HubSpot hs project dev Local Development Guide","What changes refresh in hs project dev?","Do JSON config files update automatically in local development?","Is hs project watch still the recommended local loop?"]},{"title":"HubSpot OAuth Redirect URL and Scopes Checklist","url":"https://projectsappguide.com/hubspot-oauth-redirect-scopes-install-checklist","intent":"Prepare OAuth and install-flow review.","lastSourceCheck":"2026-05-24","summary":"For multi-account and Marketplace-oriented HubSpot apps, review OAuth redirect URLs, requested scopes, backend credentials, install testing, and shared-data claims before submission or client handoff.","answerSnapshot":{"shortAnswer":"For multi-account or Marketplace HubSpot apps, OAuth redirect URLs, scopes, backend credentials, and install testing should be reviewed together before listing or production handoff.","appliesTo":"Developers preparing public, Marketplace, or multi-account HubSpot apps on the Projects developer platform.","verify":"Open the current create-app docs and Marketplace listing requirements before finalizing OAuth configuration or listing copy.","boundary":"This checklist does not guarantee OAuth install success, Marketplace approval, or policy compliance."},"claims":[{"claim":"OAuth redirect URLs are configured in `app-hsmeta.json` for OAuth app setup.","source":{"label":"Create a new app using the CLI","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app"}},{"claim":"For static auth in a privately distributed app, HubSpot's create-app docs say to remove the `redirectUrls` sub-property.","source":{"label":"Create a new app using the CLI","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app"}},{"claim":"Marketplace apps must use OAuth and should only request scopes the app needs.","source":{"label":"App Marketplace listing requirements","url":"https://developers.hubspot.com/docs/api/app-marketplace-listing-requirements"}}],"officialSources":[{"label":"Create a new app using the CLI","url":"https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app"},{"label":"App Marketplace listing requirements","url":"https://developers.hubspot.com/docs/api/app-marketplace-listing-requirements"},{"label":"Listing your app","url":"https://developers.hubspot.com/docs/apps/developer-platform/list-apps/listing-your-app/listing-your-app"}],"faq":[{"question":"When do I need OAuth instead of static auth?","answer":"Marketplace apps must use OAuth according to HubSpot's Marketplace requirements. Static auth is a separate option for privately distributed app cases and should be checked against the current create-app docs."},{"question":"Where should OAuth redirect URLs be configured?","answer":"HubSpot's create-app docs show redirect URLs inside the `auth` configuration of `app-hsmeta.json` for OAuth app setup."},{"question":"Should scopes match listing and shared-data claims?","answer":"Yes. Marketplace requirements connect requested scopes with shared-data accuracy, so requested scopes should match implemented behavior and user-facing data-flow claims."}],"naturalLanguageQuestions":["HubSpot OAuth Redirect URL and Scopes Checklist","When do I need OAuth instead of static auth?","Where should OAuth redirect URLs be configured?","Should scopes match listing and shared-data claims?"]}]}