Skip to main content
When you create a new project in Workshop Cloud, you choose one of six starting templates. Each sets up a different tech stack and project structure that Workshop uses as a foundation when building your app. The three web templates vary on two things: whether they include a Python backend, and whether the frontend is React or plain HTML.

Template Options

Dynamic React App

A React frontend with a Python (FastAPI) backend. The best choice for custom, design-rich applications where you want full control over the UI. Best for:
  • Custom-designed dashboards and data apps
  • Interactive single-page applications
  • Projects requiring specific React component libraries or design systems
  • Apps with complex frontend state management
What you get:
  • React frontend with full component architecture
  • FastAPI Python backend for APIs and business logic
  • Built-in frontend build pipeline
  • One-click publish support

Static React App

The same React frontend as above, with no backend. The whole project builds to static files, so there’s no server to run. Best for:
  • Marketing sites, landing pages, and portfolios
  • Client-side apps that don’t store data or sign users in
  • Projects that talk only to third-party APIs from the browser
What you get:
  • React frontend with full component architecture
  • No server, database, or secrets to manage
  • One-click publish support
Choose this over Dynamic React App when you don’t need a server, a database, or secrets. If you’re unsure, start with Dynamic React App — it can do everything this template can, plus server-side work.

Dynamic HTML App

A Python (FastAPI) backend with a plain HTML/CSS/JavaScript frontend. Pick this when your tools don’t support React — otherwise Dynamic React App is the better choice, since it does the same server-side work with a richer frontend. Best for:
  • Libraries or tools that don’t have React bindings
  • API-first applications with minimal frontend
  • Projects using vanilla JavaScript or lightweight libraries
  • Quick prototypes that need server-side logic
What you get:
  • FastAPI backend for building Python APIs
  • Full control over HTML, CSS, and JavaScript — no framework overhead
  • Flexible architecture for straightforward applications
  • One-click publish support

Streamlit App

A Streamlit application — 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
  • One-click publish support

Anything

An empty project with no preset stack. You start with a clean slate and tell Workshop exactly what to build. Use this for desktop apps, working with files on your computer, custom web apps, or ad-hoc tasks — anything that doesn’t fit the other templates, or when you want to experiment with a specific framework or approach.
Desktop apps and working with files on your computer are only possible in Workshop Desktop — the cloud sandbox can build custom web apps and run ad-hoc tasks, but it has no access to your machine.
Anything projects don’t support one-click publishing because there’s no predefined tech stack for Workshop to detect and deploy automatically. If you need one-click publish, start with Dynamic React App, Static React App, Dynamic HTML App, or Streamlit App.

Import from GitHub

Start from an existing repository. Workshop clones the repo into a new project so you can continue building on top of existing code. Best for:
  • Continuing work from an existing codebase
  • Collaborating on a project that lives in GitHub
  • Migrating a project into Workshop Cloud

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 six options: Dynamic React App, Static React App, Dynamic HTML App, Streamlit App, Anything, and Import from GitHub. 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.

Add-Ons

When creating a project, you can enable Add-Ons — AI Providers and Database Providers — that Workshop provisions automatically alongside your project.
  • Dynamic React App, Static React App, and Dynamic HTML App templates auto-enable Gemini (AI Provider) and Neon (Database Provider with Neon Auth) by default. You can toggle these on or off before creating the project.
  • Streamlit App and Anything templates start with no Add-Ons enabled.
You can change Add-Ons at any time in Settings → Resources → Add-Ons.
AI Providers provision managed connectors for Anthropic, OpenAI, or Gemini — no API keys or setup required. Usage is billed to your Workshop credits.Database Providers provision a managed Neon serverless Postgres database with built-in authentication (Neon Auth). Workshop handles credentials, auth domain syncing, and cleanup automatically.

When to Use Each Template

Start with Dynamic React App if you care about design and layout. Use Streamlit App if you want to move fast and the built-in components are sufficient.
Streamlit App 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 Dynamic React App for component-based architecture with a design system, or Dynamic HTML App for lightweight HTML/CSS/JavaScript without framework overhead.
Start with Anything. 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 Dynamic React App — it’s the most flexible default for anything interactive, or Dynamic HTML App for simple sites.
Use Static React App. It builds to static files with no backend, which makes it faster to publish and cheaper to run. If you later need to store data or sign users in, switch to Dynamic React App.

Template and Preview Behavior

The Dynamic React App, Static React App, Dynamic HTML App, and Streamlit App templates all 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 — All of them support one-click deployment to a shareable URL
If you outgrow what Workshop Cloud supports, you can sync your project to Workshop Desktop and continue with full-stack flexibility.