{
  "$type": "site.standard.document",
  "description": "Vals are being upgraded to support multiple files, folders, and more",
  "path": "/upgrading",
  "publishedAt": "2025-04-23T00:00:00.000Z",
  "site": "at://did:plc:a2rdzfdxkjwerrfrpbwcipb2/site.standard.publication/3jd443afc2222",
  "textContent": "Today, we’re unifying our two primitives — vals and projects — into a single primitive: the val, with the best features of both.\n\nHistorically, vals have been simple and lightweight, but limited to a single file. This upgrade will preserve the elegant spirit of our platform while supporting more complex code and collaborative workflows. This upgrade will help you create bigger things on Val Town – APIs, internal tools, fullstack apps, blogs (like this one), and much more – without sacrificing the simplicity you've always loved about vals.\n\nLegacy vals will temporarily become projects during this migration. Post-migration, the concept of projects will disappear entirely — leaving only upgraded vals. In short: legacy vals → projects → vals.\n\nTimeline\n\nFor most users, no upgrade action is required. We’ll auto-migrate your vals next week. All existing HTTP endpoints, crons, email handlers, and custom domains will be preserved.\n\nFor those with mission-critical vals or who use our API to edit or create vals, you can start upgrading your legacy vals today and integrating with our updated API.\n\n- April 23, 2025 – Announcement of changes & API deprecations.\n- April 30, 2025 – All remaining legacy vals auto-upgraded. Deprecated API routes become read-only.\n- May 1, 2025 – The term projects will no longer exist — everything will simply be a val.\n\nIf you need more time, please contact us at help@val.town and we'll work with you.\n\nUpgrading\n\nWe will upgrade all remaining legacy vals on April 30, 2025.\n\nYou can proactively upgrade by:\n\n- Going to the Settings of any legacy val.\n- Clicking Upgrade.\n\nSee more details in our docs.\n\nAPI Changes\n\nToday, we're introducing the following API routes:\n\n\n\nNote: During this transition,  is your . You can grab it by clicking  >  on any new val.\n\nWe are deprecating these routes:\n\n\n\nView our updated API reference here.\n\nAll  API routes become read-only on April 30, 2025. If you rely on writing to those routes, please upgrade to our new  API. All deprecated API routes will continue serving historical legacy val data.\n\nSDK changes\nWe've also released a new major version of the Val Town SDK, , using these new endpoints. The deprecated routes above are not accessible in this new version of the SDK.\n\nUnpinned SDK imports will automatically pull the latest version upon your next edit / save. At that point, your SDK calls will temporarily break until you upgrade. To upgrade, update every mention of  → ,  → . \n\nWhat's next\n\n1. Upgrade your mission-critical vals early.\n2. Update your Val Town API & SDK usage to  routes.\n3. All remaining legacy vals migrate on April 30, 2025.\n4. Migration completes on May 1, 2025.\n\nWe're committed to making this transition smooth for you — reach out anytime via email or Discord if you need assistance. We appreciate your help and patience through this migration.",
  "title": "Upgrading vals"
}