Skip to main content
When you create a new project in Workshop Cloud, you choose one of three starting templates. Each sets up a different tech stack and project structure that Workshop uses as a foundation when building your app.

​
Template Options

​
HTML + Python

The default template for Workshop Cloud. It pairs a FastAPI Python backend with a static HTML/CSS/JavaScript frontend, giving you full control over the user interface while keeping Python for data processing and API logic. Best for:
  • Custom-designed dashboards and data apps
  • API-first applications where you want full frontend control
  • Projects that need specific JavaScript libraries or CSS frameworks
  • Apps with pixel-perfect styling requirements
What you get:
  • FastAPI backend for building Python APIs
  • Full control over HTML, CSS, and JavaScript
  • Flexible architecture for complex applications

​
Streamlit

A Python-native framework optimized for data apps. Streamlit handles UI rendering automatically — you write Python, and it generates interactive widgets, charts, and layouts. Best for:
  • Rapid analytics and data exploration tools
  • KPI dashboards and chart-heavy applications
  • Interactive data tools with sliders, dropdowns, and forms
  • Quick prototypes that need a polished UI fast
What you get:
  • Built-in UI components (buttons, charts, tables, forms, sliders)
  • Automatic state management and caching
  • Native data connector integrations
  • Less code needed for interactive interfaces

​
Blank (None)

An empty project with no template files. You start with a clean slate and tell Workshop exactly what to build. Best for:
  • Projects where you have something very specific in mind
  • Experimentation with frameworks or languages not covered by the other templates
  • Maximum flexibility and full control from the start
Blank projects don’t support one-click publishing because there’s no predefined tech stack for Workshop to detect and deploy automatically. If you need publishing, start with HTML + Python or Streamlit. Blank projects still give you full access to the cloud sandbox — you can build and run anything that works in a Linux VM.

​
How to Select a Template

1

Click New Project

From the Projects page, click the New Project button.
2

Choose your template

In the project creation dialog, you’ll see three options under Tech Stack: Streamlit, HTML + Python, and None. Click the one you want.
3

Name your project and create

Enter a project name and click Create Project. Workshop remembers your last template selection, so it will be pre-selected next time.

​
When to Use Each Template

Start with HTML + Python if you care about design and layout. Use Streamlit if you want to move fast and the built-in components are sufficient.
Streamlit is the best choice. Its built-in widgets (date pickers, dropdowns, sliders) and charting libraries let you create interactive data exploration tools with very little frontend code.
Choose HTML + Python. You get direct access to HTML, CSS, and JavaScript, so you can use any frontend library or design system.
Start with Blank. You can install any packages, use any framework, and structure the project however you want. Keep in mind that one-click publishing won’t be available.
Go with HTML + Python — it’s the most flexible default. You can always tell Workshop to change the approach mid-project.

​
Template and Preview Behavior

Both HTML + Python and Streamlit templates work seamlessly with the preview pane and one-click publishing:
  • Preview — Your app automatically appears in the preview pane as Workshop builds it, regardless of which template you chose
  • Publish — Both templates support one-click deployment to a shareable URL
If you outgrow what Workshop Cloud supports, you can sync your project down to Workshop Desktop and continue with full-stack flexibility.