Skip to main content

​
What are Bases?

A base is a project template backed by a Git repository. When you create a project from a base, Tesslate clones the repository into your project container, installs dependencies, and starts the dev server. This gives you a fully working application in seconds instead of starting from scratch. Each base is stored as a MarketplaceBase record in the database with the following key properties:
  • git_repo_url: The GitHub (or other provider) repository that gets cloned
  • category: Classification such as fullstack, frontend, backend, or mobile
  • tech_stack: Array of technologies used (for example, ["React", "FastAPI", "PostgreSQL"])
  • features: Array of capabilities (for example, ["Hot reload", "API ready", "Database setup"])
  • tags: Searchable keywords (for example, ["vite", "react", "tailwind"])

Save Time

Start with a working application instead of configuring from scratch

Best Practices

Learn from well-structured, tested project layouts

Pre-configured

Dependencies, build tools, and dev server are already set up

Customizable

Every file is yours to modify after creation

​
Types of Bases

​
Official Bases (Tesslate-Seeded)

These are maintained by the Tesslate team and ship with every installation. They include:
BaseTech StackDescription
Next.js 16 StarterNext.js, React, TypeScriptFull-featured Next.js application
Vite + React + FastAPIReact, Vite, FastAPI, PostgreSQLFull-stack with Python backend
Vite + React + GoReact, Vite, GoFull-stack with Go backend
Expo StarterReact Native, ExpoMobile application template

​
Community Bases (User-Submitted)

Any user can submit a base to the marketplace by providing a public Git repository URL. Community bases cover a wide range of frameworks:
Django, Laravel, Rails, .NET, Spring Boot, and more. Community bases bring support for frameworks beyond the default Node.js ecosystem.
Go (Gin, Fiber, Echo), Rust (Actix, Axum), Python (Flask, Django), PHP (Laravel, Symfony).
Flutter, React Native (Expo), Tauri, and Electron starter templates.
Vue 3, Svelte, Angular, Astro, Solid, and various React configurations.
Community bases that lack a TESSLATE.md configuration file may need agent-assisted startup. If the dev server does not start automatically, the platform will offer an “Ask Agent to start it” button that lets the AI figure out the correct startup command.

​
Visibility

Bases have a visibility property:
  • public: Visible to everyone in the marketplace
  • private: Only visible to the creator
Bases created by the Tesslate team (where created_by_user_id is null) are always public.

​
Finding Bases

1

Open the Marketplace

Click Marketplace in the sidebar navigation.
2

Select the Bases Tab

Switch to the Bases section to browse available templates.
3

Filter and Search

Filter by category (fullstack, frontend, backend, mobile) or search by name, tech stack, or tags.
4

View Details

Click a base to see its full description, tech stack, features, download count, and user rating.
5

Install

Click Install to add the base to your personal library.

​
Creating a Project from a Base

1

Install the Base

Add the base to your library from the Marketplace (if you have not already).
2

Open the Dashboard

Navigate to your Dashboard and click Create New Project.
3

Select Base as Source

Choose Base as your project source, then pick from your installed bases.
4

Name Your Project

Enter a project name. Tesslate generates a unique slug automatically (for example, my-saas-app-x7k2m1).
5

Wait for Initialization

A background task clones the base repository, installs dependencies, and starts the dev server. This typically takes 10 to 30 seconds.
Behind the scenes, the API call looks like this: 
POST /api/projects/
{
  "name": "My SaaS App",
  "source_type": "base",
  "base_id": "<base-uuid>"
}
The server returns a task_id that the frontend polls until the project setup completes.

​
Base Data Model

For developers and advanced users, here is what the MarketplaceBase record includes:
  • id: Unique UUID
  • name: Display name (for example, “Next.js Starter”)
  • slug: URL-safe identifier (for example, nextjs-starter)
  • description: Short summary
  • long_description: Full description in Markdown

​
Submitting Your Own Base

You can contribute bases to the marketplace by submitting a public Git repository.
1

Prepare Your Repository

Make sure your repository is publicly accessible, has a working dev server configuration, and ideally includes a TESSLATE.md file that defines the startup command and port.
2

Open the Submit Base Dialog

In the Marketplace, click Submit Base (or find the option in your Library).
3

Provide Details

Enter the repository URL, name, description, category, tech stack, and tags.
4

Set Visibility

Choose public to make it available to everyone, or private to keep it in your personal library only.
5

Submit

Your base is created with your user ID as the created_by_user_id. Public bases appear in the marketplace browse page.
Adding a TESSLATE.md file to the root of your repository helps Tesslate detect the correct startup command, port, and framework. Without this file, the platform falls back to npm install && npm run dev on port 3000, which may not work for non-Node.js projects.

​
Ratings and Reviews

Users can leave reviews on bases with a 1 to 5 star rating and an optional text comment. The average rating and review count are displayed on the base card in the marketplace, helping others make informed decisions.

​
Best Practices

Match the base’s tech stack to your project requirements. If you need a Python backend, choose a base that includes FastAPI or Django rather than adding it manually after creation.
If you are submitting a base, add a TESSLATE.md file that specifies the framework, startup command, and port. This ensures reliable automatic startup for every user who creates a project from your base.
Higher-rated bases with more downloads tend to be better tested and maintained. Read reviews to understand any known issues or limitations.
After creating a project from a base, the code is entirely yours. Modify any file, add or remove dependencies, and restructure the project to fit your needs.

​
Next Steps

Browse the Marketplace

Discover all available bases and AI agents

Create a Project

Use a base to start your next project