Skip to content
Docs | Val Town

Overview

Projects are groups of related vals, files, and folders that are versioned together. They are used to manage large codebases, organize related files, and collaborate with others.

Learn more about why we created Val Town Projects in our announcement post.

Project features

  • Versioned Workspace: Projects contain and track changes to vals, files, folders, READMEs via an version number that goes up on any change to any file
  • Multiple Entrypoints: Add multiple HTTP, Cron, Email, and Script vals
  • Relative Imports: Import files and folders relative to the project root (ie. import foo from '../bar/foo')
  • Static Files: Add static files (HTML, CSS, Markdown, etc) to projects
  • Scoped Environment Variables

Collaboration

Branches Create branches for feature development, testing, and sharing
Forks Fork another user's project to make changes and send a pull request

Limitations

  • Maximum files per project: 1000
  • Maxmim branches per project: 100
  • Binary files are not supported. We recommend Blob Storage.
  • Free tier users are limited to 5 private or unlisted projects. Pro users can have unlimited private projects. All users can have unlimited public projects.

Please contact us if you need more resources or have any questions.