# arXiv Connection
Source: https://docs.youware.com/connections/arxiv-connection
Transform arXiv papers into structured, AI-ready knowledge. Summarize breakthroughs, compare research directions, and launch content experiences fueled by the latest academic insights.
**Bring cutting-edge research into YouWare without manual data wrangling.** Toggle on the arXiv connection and the builder can reference live paper metadata, abstracts, authors, citations, and PDF links—no scraping or API keys required.
## Quick Summary
* **Purpose:** Generate research hubs, analysis dashboards, and content pipelines powered by real arXiv papers
* **Pulls:** Titles, abstracts, categories, author lists, publication dates, citations, PDF links, and code repositories (when available)
* **Best for:** Research teams, technical bloggers, investor memos, education portals, conference landing pages
***
## What is the arXiv Connection?
Mention any topic, category, author, or arXiv ID in your prompt—YouWare fetches the relevant papers and builds experiences around them. Summaries, comparison tables, citation callouts, and call-to-actions all use verified metadata direct from arXiv.
Surface the most cited or most recent papers with executive summaries and key metrics
Visualize category heatmaps, publication momentum, and collaboration networks
Feed newsletters, blog posts, or prompt libraries with AI-generated summaries and action items
***
## How It Works
Open **Connections → arXiv** in your workspace and toggle it on. No credentials or rate-limit configuration required.
In your prompt, specify topics, arXiv categories, authors, or timeframes. Example:\
*“Create a briefing on diffusion models published on arXiv in the last six months, highlighting breakthroughs and practical implications.”*
YouWare assembles paper cards, abstract highlights, comparison tables, and CTA buttons linking to full PDFs or code repos.
When you need newer publications, re-run your prompt to fetch the latest data. Background auto-updates are not available yet.
***
## Prompt Example
```text theme={null}
"Generate a research dashboard summarizing the top five arXiv papers on multimodal LLMs,
including abstracts, author lists, publication dates, citations, key takeaways,
and links to PDFs and GitHub repositories."
```
***
## Example: AI Safety Research Briefing
Run a prompt such as the one above and YouWare will:
1. Query arXiv for papers matching your topic and timeframe.
2. Extract abstracts, methodologies, links, and author affiliations.
3. Produce analyst-ready summaries, comparison tables, and recommended follow-up reading.
4. Add shareable widgets—email signup, download bundles, or “Discuss with the team” CTAs.
Perfect for CTO updates, investor memos, academic newsletters, or student research portals.
***
## Best Practices
* **Narrow the scope:** Include category tags (e.g., `cs.CL`, `cs.AI`) or keywords to keep results focused
* **Blend qualitative + quantitative:** Ask for metrics (citations, publication date) alongside commentary (“Why it matters”)
* **Call out actionable insights:** Request “Key takeaways”, “Implementation checklist”, or “Questions for stakeholders” sections
* **Pair with Backend:** Store curated reading lists, reviewer notes, or approval workflows using YouWare Backend
* **Automate newsletters manually:** Re-run the prompt on your preferred cadence to keep subscribers updated with the latest research
***
## Real-World Use Cases
Deliver weekly research digests highlighting risks, opportunities, and strategic recommendations.
Convert raw papers into digestible posts with summaries, quotes, and discussion prompts.
Build curated reading lists, study guides, and quiz generators around the latest papers.
Track innovations across sectors, compare competing approaches, and annotate strategic signals.
***
## Frequently Asked Questions
No. Enabling the connection inside YouWare automatically unlocks access to arXiv metadata—no additional setup required.
Include category codes (e.g., `cs.LG`, `math.PR`) or phrases like “published after January 2024” directly in your prompt.
Yes. Download links, DOI references, and GitHub repos are included automatically when available on arXiv.
Absolutely. Combine the arXiv connection with YouWare Backend, Notion, or Supabase to overlay proprietary notes, roadmap items, or team assignments.
New papers are pulled only when you regenerate the page. Automatic background updates or scheduling are not supported yet.
***
**Prompt starter:**\
`“Create a weekly newsletter section on reinforcement learning breakthroughs from arXiv, summarizing the top five papers with key insights, author affiliations, PDF links, and suggested business applications.”`
# Figma Connection - Convert Designs to Code with AI
Source: https://docs.youware.com/connections/figma-connection
Connect Figma to YouWare's AI and automatically convert your designs into pixel-perfect, responsive web code. Complete setup guide and best practices.
## What is the Figma Connection?
The Figma connection bridges the gap between design and development by connecting your design files directly to YouWare's AI. Using Figma's "Copy link to selection" feature, you can point our AI to any component, section, or entire page in your design. The AI then analyzes the visual context to generate pixel-perfect web code.
Use your Figma designs as the blueprint for precise AI code generation
Generate HTML, CSS, and JavaScript that matches your designs exactly
Turn design mockups into functional web pages within minutes
## Key Benefits
**Design-to-Code Velocity**
Transform design concepts into working prototypes and production code in minutes, drastically reducing development time.
**Pixel-Perfect Code**
The AI uses your Figma design as a blueprint, eliminating manual work to match code to design specifications.
**Seamless Workflow**
Designers and developers work in parallel, with the design file serving as the single source of truth for AI generation.
## Setup Your Figma Access Token
You need a Personal Access Token (PAT) to connect Figma. This token allows YouWare's MCP to securely access your design files via the Figma API.
Click on your avatar in the top-left corner of Figma and select **Settings** from the dropdown menu.
In the Settings page, select the **Security** tab and scroll down to the **Personal access tokens** section.
Click the **Generate new token** button to create a new access token.
Set up your token with the following configuration:
* **Token Name:** `YouWare MCP` (or any recognizable name)
* **Expiration:** 90 days (recommended for security)
* **Required Scopes:**
* `file_content:read`
* `file_dev_resources:read`
* `projects:read`
Copy the token immediately after generation - you won't be able to see it again!
## Best Practice: Section-by-Section Conversion
For optimal results, convert your Figma designs section by section rather than converting entire pages at once.
### Why This Approach Works
AI focuses on specific details of each section for precise code generation
Each section gets properly organized code with clean boundaries
Quickly identify and fix issues in specific sections
Iterate rapidly on your designs and see them live immediately | Fast feedback loop | Fast feedback loop | Fast feedback loop
### Implementation Process
In Figma, select a specific section (header, hero, features, footer, etc.)
Right-click and choose "Copy link to selection"
Paste the link into YouWare and let the AI generate that section's code
Continue this process for each major section of your design
The AI will combine all sections into a cohesive, fully functional page
## Real-World Use Cases
**Portfolio Site Development**
**Scenario:** You've designed a stunning portfolio layout in Figma and need a fast, pixel-perfect website.
**Solution:** YouWare's AI reads your Figma design as the single source of truth, generating clean, responsive code that matches your creative vision exactly.
**Example Prompt:**
```
Convert my Figma portfolio design into a responsive website.
Here's the link to my hero section: [Figma link].
Make sure the typography, spacing, and colors match exactly.
```
**Product Landing Page**
**Scenario:** Your marketing team has a tight deadline to launch a new product landing page.
**Solution:** The AI instantly generates a live, functional webpage from your Figma design, meeting urgent launch deadlines.
**Example Prompt:**
```
Create a product landing page from this Figma design: [Figma link].
Include the hero section, features grid, testimonials, and CTA button.
Make it fully responsive and conversion-optimized.
```
**MVP Development**
**Scenario:** You need to turn designer mockups into a working prototype quickly for investor meetings.
**Solution:** The AI converts Figma designs into functional code section by section, creating professional prototypes rapidly.
**Example Prompt:**
```
Convert this Figma dashboard design into a working prototype: [Figma link].
Start with the navigation bar and main content area.
Make all buttons functional with proper interactions.
```
**Code Delivery**
**Scenario:** Your clients want working HTML/CSS they can use immediately without additional development work.
**Solution:** Deliver both beautiful designs and production-ready code without learning programming languages.
**Example Prompt:**
```
Turn my Figma website design into clean HTML and CSS code: [Figma link].
Generate each section separately starting with the header.
Include semantic HTML and responsive design patterns.
```
## Frequently Asked Questions
The Figma connection links your design files to YouWare's AI, allowing automatic conversion of visual designs into pixel-perfect, functional web code. Use it when you want to turn design mockups into real websites without manually coding every detail.
No coding knowledge required! Simply copy a link to your Figma design, paste it into YouWare, and the AI generates the code automatically with proper structure and responsive design.
1. Click your avatar in Figma and select **Settings**
2. Go to the **Security** tab
3. Scroll to **Personal access tokens** and click **Generate new token**
4. Name it (e.g., "YouWare MCP"), set expiration (90 days recommended)
5. Enable these scopes: `file_content:read`, `file_dev_resources:read`, `projects:read`
6. Copy the token immediately (you won't see it again!)
You need three essential scopes:
* `file_content:read` - Allows reading design content and specifications
* `file_dev_resources:read` - Allows reading development resources and assets
* `projects:read` - Allows reading project structure and organization
**We strongly recommend section-by-section conversion** for optimal results:
* Higher accuracy and precision in code generation
* Better organized code structure with clean boundaries
* Easier debugging and targeted adjustments
* Faster iterations on specific sections without affecting others
In Figma, select the frame or section you want to convert, right-click, and choose "Copy link to selection." Then paste that specific link into YouWare for targeted code generation.
Yes! YouWare's AI generates pixel-perfect code matching your Figma design's typography, spacing, colors, and layout specifications. Section-by-section conversion provides the most accurate results.
Absolutely! The AI recognizes responsive design patterns in your Figma file and generates responsive CSS code that adapts beautifully to different screen sizes and devices.
Simply copy the link to the updated section and regenerate that specific part. The AI will create fresh code based on your latest design changes without affecting other sections.
Yes! You can use any Figma file you have access to, including Community templates. Just make sure to duplicate them to your workspace first so you have full access permissions.
# GitHub Connection for AI-Powered Code Generation
Source: https://docs.youware.com/connections/github-connection
Connect YouWare to GitHub repositories for version control, collaboration, and intelligent code generation with full repository context.
## Understanding the GitHub Connection Tool
The GitHub connection links your YouWare project to a GitHub repository, providing version control, collaboration features, and secure code backup. The AI can read your existing code to understand your project's structure, tech stack, and coding style, ensuring seamlessly integrated code generation.
Track every change with full rollback capability and GitHub workflows
AI reads your codebase to understand structure, tech stack, and coding style
Work seamlessly with developers using Pull Requests and Issues
## Generate Your GitHub Personal Access Token for MCP Connection
To connect GitHub, you need a Personal Access Token (PAT). Follow the visual guide below to create your token:
### Key Configuration Points
**Token Name**: Use a descriptive name like `YouWare MCP` to easily identify this token later
**Repository Access**: Select **Public repositories** for basic access. This allows MCP to read from your public repositories, which is typically sufficient for AI-powered webpage generation
**Expiration**: Choose an expiration time that fits your workflow. Shorter expiration times are more secure
**Critical**: Copy your personal access token immediately after generation—you won't be able to see it again! Store it securely and never share it publicly or commit it to version control.
Need more details? Visit the [GitHub Personal Access Token creation page](https://github.com/settings/tokens/new) to get started.
## Real-World Use Cases
**Scenario**: Maintaining a public open-source library with auto-generated documentation that stays in sync with code changes
**How It Helps**: The AI reads your GitHub repository to understand code structure and generates the documentation site. With each new version push, the AI automatically updates docs—ensuring zero documentation drift.
**Scenario**: Enforcing code standards across a distributed development team
**How It Helps**: The AI reads your existing GitHub codebase to learn your style, ensuring all new components and features are perfectly consistent. This tech-driven consistency saves countless hours in code review and refactoring.
## Frequently Asked Questions
For basic read access to public repositories, minimal permissions are sufficient. For private repositories or write access, you'll need to grant additional scopes.
Yes. The token is used only to read repository data via GitHub's secure API. Always keep your token private and never share it publicly.
Absolutely. You can revoke or regenerate tokens at any time from your GitHub settings.
Yes, but you'll need to configure the token with appropriate permissions for private repository access.
# Google Maps Connection
Source: https://docs.youware.com/connections/google-maps-connection
Pull live location data, reviews, and map embeds straight into your YouWare projects. Build discovery pages, local directories, and trip planners in minutes.
**Turn real-world places into rich digital experiences.** Once the Google Maps connection is enabled, YouWare can reference business profiles, ratings, photos, and coordinates directly in your prompts—no API key configuration required.
## Quick Summary
* **Purpose:** Generate map-first pages, local guides, and location dashboards using live Google Maps data
* **Pulls:** Names, categories, ratings, review counts, open hours, addresses, coordinates, photos, and navigation links
* **Updates:** Data refreshes whenever you regenerate the page or request a manual sync
* **Best for:** Travel guides, store locators, competitor research, real-estate landing pages, city portals
***
## What is the Google Maps Connection?
Mention any place, neighborhood, or coordinates in your prompt—YouWare fetches verified Google Maps data and designs sections around it. Build a “Best coffee in Seattle” directory, surface review highlights for “Mr Beast burger locations”, or embed interactive maps that jump straight to Google navigation.
Curate lists of venues with photos, ratings, and quick filter controls
Pair hero sections with embedded maps, itineraries, and CTA buttons for directions or reservations
Compare nearby businesses, highlight review sentiment, and visualize coverage areas with heatmaps
***
## How It Works
Visit **Connections → Google Maps** and toggle it on. YouWare handles authentication—no Google Cloud setup required.
Reference locations, business names, neighborhoods, or search intent inside your prompt. Example:\
*“Create a research microsite comparing the top-rated coffee shops around Pike Place Market in Seattle.”*
YouWare assembles cards, tables, itinerary timelines, and embedded maps populated with fresh Google Maps data.
Regenerate the page or trigger a manual sync to update hours, ratings, and new locations.
***
## Prompt Example
```text theme={null}
"Create a research microsite for Tokyo Tower visitors that highlights the five best cafes within 1 km,
including their specialties, signature drinks, opening hours, transport options, and a one-click navigation button."
```
***
## Example: Tokyo Tower Cafe Tour
When you run the prompt above, YouWare:
1. Queries Google Maps for cafés within the requested radius, ranked by rating and review volume.
2. Generates rich cards for each café (brand story, must-try drink, hours, contact info, transport notes, and latest review snippets).
3. Embeds a Google Maps component with custom pins plus a “Plan Route” button that launches Google Maps directions from the user’s location.
4. Creates comparison tables (price level, seating, Wi-Fi availability) and suggested itineraries around Tokyo Tower.
This lets you ship an actionable local guide in minutes—perfect for tourism boards, creator newsletters, concierge teams, or sponsored campaigns.
***
## Best Practices
* **Be precise with geography:** Mention city, neighborhood, or radius to keep results relevant
* **Mix narrative + data:** Ask for storytelling sections (“Why visit?”, “Local tips”) alongside map cards
* **Group by intent:** Separate categories like dining, lodging, attractions, or coworking spaces for easier browsing
* **Pair with Backend:** Save user-generated favorites or trip notes in YouWare Backend for personalized experiences
* **Enable route planning:** Ask explicitly for “one-click navigation” to surface Google Maps links or embedded directions
* **Use Street View + photos:** Request hero images or galleries sourced from Google photo data to boost engagement
***
## Frequently Asked Questions
No. Enabling the connection inside YouWare is all it takes. We handle the credentials and quota—nothing else to configure.
Any public location indexed by Google Maps: cafes, attractions, coworking spaces, retail stores, venues, landmarks, and more.
Yes. Mention city names, neighborhoods, postal codes, or distance constraints (e.g., “within 2km of Eiffel Tower”) in your prompt.
Every regeneration fetches the latest info. You can also request a manual refresh from the Connections panel if you expect major changes.
Definitely. Combine with YouWare Backend, Notion, or Supabase connections to enrich location content with internal notes, promotions, or community feedback.
Yes. Ask for one-click navigation, itinerary builders, or step-by-step directions. YouWare will output Google Maps links, embedded routes, or call-to-action buttons based on your prompt.
YouWare abstracts quota management, but extremely high-volume use cases may require additional allowances. Reach out to support for enterprise usage.
***
**Prompt starter:**\
`“Plan a café crawl within 1 km of Tokyo Tower that ranks the top five spots, includes signature drink highlights, user review snippets, transit tips, and embeds a Google Maps route for the walking tour.”`
# YouWare MCP Tools Introduction
Source: https://docs.youware.com/connections/mcp-introduction
Learn how to integrate external services like Figma, Notion, and more into your YouWare project with MCP Tools. Simple setup, powerful connections.
# Connect Your Project to Any Service
Connect your project to the services you love - Figma, Notion, and dozens more.
## Why Connections Matter
Remember when smartphones were just for calls? Then apps came along and changed everything. **That's exactly what MCP Tools do for your YouWare project.**
MCP Tools are like apps for your website. Install one, and suddenly your project can connect with the services you already love—Figma, Notion, and dozens more. Think of them as smart adapters that help your site plug into the tools you rely on every day, so everything works together instead of living in separate silos.
### What becomes possible?
If you've ever wished your YouWare project could:
**Pull in your latest Notion pages** automatically
**Switch between multiple AI models** to find the perfect fit
**Turn your Figma designs into live pages** in seconds
**Display real-time game leaderboards** without breaking a sweat
...then you're in the right place. YouWare MCP Tools make all of this possible with just a few clicks.
## How do I add a connection to my project?
### Step 1: Access the MCP Tool Panel
The **MCP Tool** entry point is located at the **bottom left** of the input box on the page creation screen. Click it to expand the list of available tools and connections for your current project.
### Step 2: Add Your Connection
You can add connections by **combining natural language prompts with MCP Tool actions**:
**Describe your needs** in the chat input using natural language
**Select the corresponding tool** from the MCP Tool panel
**Examples:**
```text Example 1 theme={null}
Prompt: "Add a backend voting system with a leaderboard"
Action: Click to enable the YouBase tool in the MCP Tool panel
```
```text Example 2 theme={null}
Prompt: "Connect to my Figma design and convert it to code"
Action: Click to enable the Figma tool in the MCP Tool panel
```
### Step 3: Authorize & Configure (if needed)
Some tools (such as **Figma** and **database-related tools**) require authorization and linking. Don't worry—these tools come with:
* Step-by-step configuration instructions
* Built-in examples
* Simple guidance to get you started quickly
### Step 4: Generate Your Project
Press **Enter** and wait for YouWare to create your project with the integrated tools ready to use.
**Performance Tip:** The more MCP Tools you enable, the slower your project generation will be. Each tool adds processing time as the AI needs to coordinate multiple services. For optimal performance, only enable the tools you actually need for your project. You can always add more tools later!
***
## Finding Your Perfect Tool
**Not sure where to start?** Here's a quick guide to help you find the right tool for your needs:
**Built-in Tools**: Animation Library, Icon Library, Image Generator, and Unsplash are now automatically available in every project—no setup needed! Just describe what you want and the AI will use them automatically.
**Turn designs into code** → Use Figma
**Collect & manage data** → Check out YouBase or Supabase
**Display dynamic content** → Connect Notion, GitHub, or YouTube
**Embed interactive maps** → Go with Google Maps
**Access research papers** → Integrate arXiv
**Welcome to the YouWare Way** - Where your ideas become reality faster than you thought possible.
***
## Frequently Asked Questions
MCP Tools (Model Context Protocol Tools) are pre-built connections that extend your YouWare project's capabilities. They work like plugins or apps, allowing your website to connect with external services like AI models, databases, design tools, and content platforms—all without writing complex code.
Not at all! That's the beauty of YouWare connections. Simply select the tool you need, describe what you want in plain English, and YouWare handles all the technical implementation. Whether you're connecting AI image generation or your Notion workspace, it's all done through our intuitive interface.
Absolutely! In fact, we encourage it. You can combine multiple MCP Tools to create powerful, feature-rich applications. For example, you might use Figma to import your design, AI API to generate content, Supabase to manage your database, and Unsplash for images—all in the same project.
**Keep in mind:** The more tools you enable, the longer it takes to generate your project. Each additional tool requires more processing as the AI coordinates between services. For best performance, start with essential tools and add more as needed.
**YouWare Backend** is our built-in data management solution—perfect for simple data storage and retrieval with zero configuration. **Supabase** is a more robust, full-featured database platform ideal for complex applications that need advanced querying, real-time updates, or authentication features. Choose based on your project's complexity.
Yes. YouWare uses enterprise-grade encryption to protect all credentials and data. When using [YouBase](/youbase/introduction), your API keys can be stored in the **Secrets** module—a dedicated secure vault that ensures:
* **Server-side only access**: Secrets are never exposed to frontend code or sent to users' browsers
* **Enterprise-grade encryption**: All credentials are encrypted at rest and in transit
* **Hidden after creation**: Secret values are never displayed after you save them
* **Full control**: You can edit, rotate, or delete your secrets anytime
We follow industry best practices for data privacy and security. Your sensitive credentials stay on the server, accessible only through backend Functions—never visible to end users.
Of course! You can add or remove connections anytime without affecting your project's core functionality. If you remove a connection, any features that depend on it will stop working, but your other features remain intact. You can always re-add it later if needed.
We're constantly adding new MCP Tools based on user feedback. If you need a specific connection, let us know through our feedback form or community forum. In the meantime, you can often use the **Web Scraper** or **API connection** tools to connect with custom services.
# Notion Connection
Source: https://docs.youware.com/connections/notion-connection
Connect Notion pages to LLMs for content-driven web project generation. Use your Notion workspace as a CMS for YouWare projects.
## What is the Notion Tool?
The Notion tool turns your Notion workspace into a powerful content management system (CMS) for your YouWare projects. Instead of copying and pasting, you can connect your Notion pages directly. The AI can then read these pages—which might contain product specifications, blog drafts, or marketing copy—and use them as the primary content source to generate a fully styled and functional website or application.
**Quick Summary:**
* **Purpose**: Uses Notion pages as a structured, content-driven input for AI generation
* **Function**: The AI reads the content, structure, and hierarchy of your Notion pages
* **Benefit**: Generate websites and apps where the content is always managed and updated directly in Notion
* **Workflow**: Perfect for teams that use Notion as their source of truth for all content
## Key Benefits
Build content in Notion first, then generate your website | Workflow-first approach | Workflow-first approach | Workflow-first approach
Change content once in Notion—your website updates automatically | Auto-sync | Auto-sync | Auto-sync
Provides the AI with rich, well-organized content, resulting in more coherent and contextually relevant generated projects.
## How to Get Your Notion Connection Secret for MCP
To connect Notion, you’ll create an **Internal Integration** (Notion’s term) and capture its secret token. This lets YouWare's MCP access only the pages you explicitly share.
Go to the [Notion Integrations page](https://www.notion.so/my-integrations) and click **+ New Integration**.
Configure the following settings:
* **Name**: Give it a name like `YouWare MCP`
* **Workspace**: Select the workspace you want to connect
* **Type**: Choose **Internal Integration**
On the settings page for your new YouWare MCP integration, find the **Internal Integration Secret** and click the **Copy** button. This is the secret key you will use in YouWare.
Keep this secret secure. It provides access to your Notion content and should never be shared publicly.
For YouWare to access a specific page or database, explicitly connect it to your new integration.
1. Go to the Notion page or database you want to use
2. Click the three dots (**...**) menu in the top right
3. Select **Add connections** (or **Add people, emails, groups, or integrations**)
4. Search for and select your **YouWare MCP** integration
Once connected, YouWare can now access this page or database through the Notion API.
By default, the integration has full read/write access. For security, you can go to the integration settings and configure fine-tuned permission scopes (e.g., only "Read content" access) to limit what the LLM can do with your data.
We recommend granting read-only access for most content-generation use cases.
## Real-World Use Cases
**Launching a content-driven blog with zero code**
You want a professional blog where you can write and publish new articles just by creating a new page in a Notion database.
**How It Helps:**
YouWare's AI generates the entire blog website, and the Notion integration acts as the CMS. You simply write in Notion, and the site updates automatically. This is content-first development that lets you focus 100% on your writing.
**Creating a dynamic product catalog from internal specs**
Your team keeps all product descriptions, features, and pricing in a Notion database and needs to generate a beautiful, searchable public product catalog.
**How It Helps:**
The AI reads the structured data from your Notion database and generates a dynamic, searchable website. Any changes to pricing or features in Notion are instantly reflected on the live site, ensuring data integrity and consistency across your business.
## FAQ
Yes, you can connect multiple pages and databases. The AI will read all connected content to understand your project's full context.
By default, the integration can have write access, but we recommend configuring it for read-only access to prevent unintended modifications. The AI primarily uses Notion as a content source.
The AI reads from Notion in real-time when generating or updating your project, ensuring it always uses your latest content.
Absolutely. Notion databases are ideal for structured content like product catalogs, blog posts, team directories, and more. The AI can read the database structure and generate appropriate interfaces.
If you disconnect or delete the integration, YouWare will no longer be able to access your Notion content. Any previously generated code will continue to work, but updates requiring Notion data will fail.
# Supabase Connection
Source: https://docs.youware.com/connections/supabase-connection
Connect your Supabase backend to power AI-generated, data-aware applications with real-time database connectivity and full-stack cohesion.
## What is the Supabase Tool?
The Supabase tool connects your YouWare project to your Supabase backend—an open-source alternative to Firebase. This connection enables the AI to use your existing data as a source of truth, reading your Supabase tables and functions to understand your data model and generate code that interacts correctly with your database.
**Key Points:**
* **Purpose**: Connects YouWare to your Supabase database and backend services
* **Function**: Allows the AI to read your data schema and use your data as context for code and content generation
* **Benefit**: Enables the AI to build data-aware applications with real-time database connectivity
* **Data Source**: Transforms your Supabase repository data into valuable context for the AI
## Key Benefits
AI generates interfaces with full knowledge of your data structure | Schema-aware | Schema-aware | Schema-aware
Build data-driven features in minutes instead of days | Quick setup | Quick setup | Quick setup
Frontend and backend work as one seamless unit | Unified architecture | Unified architecture | Unified architecture
## How to Get Your Supabase Access Key for MCP
To connect Supabase, you need to generate a Service Role Key that allows YouWare's MCP to securely access your database for content generation.
Go to the [Supabase Token Settings page](https://supabase.com/dashboard/account/tokens) to generate your personal access token.
* Click the green **Generate new token** button
* In the pop-up, give your token a name like `YouWare MCP` and confirm
* Once generated, **copy the token immediately** — you won't be able to see it again
Keep your Service Role Key secure. It provides elevated access to your database and should never be exposed in client-side code.
When connecting in YouWare, use this generated token as your Supabase Service Role Key. This grants the necessary read access for the AI to understand your data model.
Your Supabase integration is now ready to use with YouWare's AI-powered development tools.
## Real-World Use Cases
**Scenario**: Developing a custom analytics dashboard to display user engagement data tracked in Supabase to your audience or sponsors
**How It Helps**: YouWare's AI reads your existing Supabase schema and instantly generates front-end code with the correct API calls to query and display your live data. This full-stack cohesion turns raw data into beautiful, functional insights
**Scenario**: Creating a real-time inventory tracker for a pop-up shop that lets your team quickly check and update inventory levels during busy events
**How It Helps**: The AI uses the Supabase connection to generate a secure, data-aware application with forms and tables that talk directly to your database—ensuring zero-latency data management and preventing costly stock errors
## FAQ
The Service Role Key has elevated privileges and bypasses Row Level Security (RLS), making it suitable for server-side operations. The Anon Key is safe for client-side use but respects RLS policies.
Yes, when properly configured. Always keep your Service Role Key private and implement appropriate RLS policies in Supabase to control data access.
The AI can generate code that writes to your database, but the actual write operations depend on the permissions granted by your Service Role Key and your Supabase security policies.
Yes, the AI can read and understand your Edge Functions to generate code that properly integrates with your serverless backend logic.
# YouTube Connection
Source: https://docs.youware.com/connections/youtube-connection
Bring playlists, channel content, and engagement data directly into your YouWare projects. Automate updates, showcase videos, and personalize experiences with live YouTube data.
**Ship video-first experiences without manual embeds.** Once the YouTube connection is enabled, YouWare can pull live channel and video data—no personal API keys or manual syncing required.
## Quick Summary
* **Purpose:** Auto-fetch public YouTube channel + video metadata to power research sites, landing pages, and dashboards
* **Pulls:** Titles, descriptions, thumbnails, view counts, publish dates, Shorts, livestream replays, and channel stats
* **Updates:** Data refreshes every time you regenerate the page or request a sync in Connections → YouTube
* **Best for:** Channel research, creator partnerships, media kits, launch hubs, course directories, investor reports
***
## What is the YouTube Connection?
The YouTube connection lets YouWare analyze any channel you mention in your prompt—e.g. *“Build a research site for the MrBeast YouTube channel”*. The AI fetches real channel data (subscriber counts, playlists, top videos, latest uploads) and designs pages that embed playable videos with jump links back to YouTube.
Auto-generate carousels and grids with real thumbnails, durations, and view counts
Summarize creator bios, publishing cadence, top-performing content, and sponsorship highlights
Visualize trends for watch time, subscriber growth, engagement ratios, and upload frequency
***
## How It Works
In your workspace, open **Connections → YouTube** and toggle it on. No Google Cloud setup or API keys required.
In your prompt, reference the creator, channel ID, video, or keywords you need. Example:\
*“Create a competitive analysis page for MrBeast’s YouTube channel showcasing top videos, upload cadence, and audience stats.”*
YouWare builds hero sections, galleries, analytics widgets, and CTAs populated with live channel data and video links.
Whenever you regenerate or request a manual sync, YouWare fetches the latest stats and updates the layouts accordingly.
***
## Prompt Example
```text theme={null}
"Build a research microsite for the MrBeast YouTube channel.
Include subscriber milestones, a grid of the latest uploads with direct links,
and a table comparing performance of his most-watched videos."
```
***
## Best Practices
* **Be specific in prompts:** Mention channel names, playlists, or target audiences (“compare tech review channels”)
* **Mix text + video:** Ask for executive summaries, sponsor callouts, or insight panels alongside embeds
* **Combine with Backend:** Save curated playlists, survey results, or partner leads directly into YouWare Backend
* **Leverage Shorts + Livestreams:** Call out trending Shorts or upcoming live events for richer engagement
* **Use Credit Care:** Iterate on layouts without fear—undo attempts that miss the mark and retry instantly
***
## Real-World Use Cases
Showcase featured videos, embed upcoming tour dates, and plug memberships. YouWare keeps thumbnails, view counts, and CTAs fresh.
Pair official trailers with product specs, influencer reactions, and direct CTAs to purchase or subscribe.
Organize lesson playlists, surface recommended modules, and sync descriptions or transcripts for SEO.
Build verticals for shows, creators, or genres; drive traffic back to YouTube or monetize sponsorship inventory on your site.
***
## Frequently Asked Questions
No. Once the YouTube connection is enabled in your YouWare workspace, data fetching is handled automatically—no Google Cloud project or keys required.
Yes. Mention the exact channel, playlist, video IDs, or keywords in your prompt. YouWare only surfaces the sources you describe.
Absolutely. Shorts and live replay metadata are treated like standard videos—YouWare can create story strips, highlight sections, or event countdowns.
Every time you regenerate the page or request a manual sync. You can also set automatic schedules inside Connections → YouTube.
YouWare lazy-loads embeds and uses optimized thumbnails until interaction. You can also choose text-only cards that open modals or link directly to YouTube.
Yes. Blend YouTube insights with YouWare Backend, Notion, or Supabase connections to enrich pages with articles, products, or community feedback.
YouWare respects YouTube’s public data limits. For channel research use cases, default quotas are typically sufficient; high-volume enterprise needs can request expanded access through support.
***
**Need help crafting prompts?** Try:\
`“Create a competitive report comparing Marques Brownlee and MrBeast YouTube channels, including top videos, collaboration highlights, and sponsor-ready talking points.”`
# Boost
Source: https://docs.youware.com/features/boost
Intelligent AI assistant that automatically analyzes and optimizes your web pages with a single click, enhancing layout, content, and user experience while preserving your original design.
Boost is an intelligent polishing assistant for web pages. With just one click, the Agent automatically analyzes your page and executes optimizations to give your work a fresh new look.
## Getting Started
In the input area at the bottom of the project editing page, you'll find the **Boost button**. After clicking it, the Agent begins comprehensive analysis of your current webpage.
## How Boost Analyzes Your Page
When you click Boost, the AI performs an in-depth examination across three key areas:
### Analysis Areas
* **Page Structure** - Examines page structure and visual hierarchy
* **Content Quality** - Analyzes text quality and information flow
* **User Experience** - Reviews user experience and interface elements
## The Enhancement Process
Simply click the Boost button in your project editor
System automatically analyzes layout, content, and interactions
Enhancements applied while preserving your original design intent
See your improved page immediately with no additional work required
The optimization process is **fully automated** - no additional commands or prompts needed. Just one click for comprehensive page enhancement.
## Design Philosophy
Boost doesn't redesign your website. Instead, it **intelligently enhances while preserving the original intent**, elevating project quality while maintaining your creative style.
## Key Benefits
No complex setup or configuration required. Click and watch your page improve instantly.
AI-powered analysis considers layout patterns, content flow, and user interaction optimization.
Maintains your original creative vision while enhancing quality and polish.
Addresses multiple aspects of page quality in a single optimization cycle.
## Best Practices
### Before Using Boost
* Ensure your page has basic content structure
* Save your work before optimization
* Have a clear design direction in mind
### After Boost Enhancement
* Review the optimized changes
* Test functionality and interactions
* Make minor adjustments if needed
# Code Editor
Source: https://docs.youware.com/features/code-editor
Browse and edit your project's code directly in the workspace. View code instantly, edit as a subscriber, and save in real-time.
View your project's source code directly in the editor. No external tools needed. Subscribers can also edit and save changes instantly.
## Access Your Code
Click **Code Editor** to browse your complete project structure and files. You can see:
* HTML, CSS, JavaScript files
* Project file organization
* All source code
## Edit Your Code
Edit files directly and save instantly. Updates appear in your preview in real-time.
View and browse your project code. Upgrade to edit.
## What You Can Do
Browse file structure and read source code (all users)
Edit and save changes instantly (subscribers only)
Make all changes directly in YouWare
Changes apply instantly to your project preview
**Pro tip:** Mix manual code edits with AI changes. Your manual edits are saved as part of your project, and the AI will consider them when making future changes.
## Frequently Asked Questions
Yes. All users can browse and view their project code in Code Editor. Only [subscribers](https://www.youware.com/subscription?location=docs) can edit and save changes.
Yes. When you edit code as a subscriber, changes save instantly. You'll see updates in the preview immediately.
No. Code Editor lets you view and edit in the workspace. To download your complete project code, use the download feature in your project settings (requires subscription).
You can view and edit any file in your project: HTML, CSS, JavaScript, JSON, and other text-based formats.
Yes. Your manual code edits are part of your project. If you ask the AI to make changes afterward, it takes your edits into account. You can mix manual and AI editing freely.
You can use browser undo (Ctrl+Z or Cmd+Z) while editing. For larger undos, you may need to use your version control if connected to GitHub.
Yes. Code Editor includes syntax highlighting for all common web languages to make code easier to read.
Yes. Use your browser's find function (Ctrl+F or Cmd+F) to search within the Code Editor.
# CoView
Source: https://docs.youware.com/features/coview
Use screen recording with voice to communicate UI issues to the AI. Show exactly what you see instead of describing it in text.
## What is CoView?
CoView lets you record your screen and speak to show the AI exactly what you're seeing. Instead of typing descriptions, you point at elements and explain verbally—like sharing your screen with a colleague.
## Quick Start
Find and click the **CoView** button in the editor toolbar
Navigate to the issue and hover your mouse over the element
Describe what you want in natural language
Stop recording and send—the AI receives video, audio, and visual context together
Think of it as a video call with your AI assistant. Just show and tell.
## When to Use CoView
CoView shines when **showing is easier than describing**:
| Scenario | Why CoView Helps |
| ---------------- | --------------------------------------------- |
| Animation issues | AI sees the exact timing and behavior |
| Layout problems | Point directly at the spacing or alignment |
| Interactive bugs | Demonstrate the steps that trigger the issue |
| Visual polish | Say "make this pop more" while pointing at it |
### Text vs CoView: A Comparison
**Typing:**
> "The button hover animation has a delay and the color transition isn't smooth. It's the blue button in the hero section."
**CoView:**
Hover over the button and say: "Can you make this smoother?"
→ AI sees exactly which button, the current animation, and what "smooth" means in context.
**Typing:**
> "When I submit the form, there's a flash of content before the spinner shows up."
**CoView:**
Record the form submission and say: "Fix this flash."
→ AI sees the exact sequence and timing of events.
**Typing:**
> "The cards have inconsistent spacing, I think the third one has more margin."
**CoView:**
Point at the gaps while saying: "These gaps are inconsistent."
→ No ambiguity about which cards or which gaps.
## Best Practices
Keep recordings focused on a single problem for clearer communication and faster processing.
Move your cursor to the exact element as you describe it—this gives the AI spatial context.
If it's a bug, demonstrate the exact steps that cause it rather than just describing the end state.
Speak naturally. "This feels clunky" works better than technical jargon.
### Combining with Other Features
CoView works well with other YouWare features:
| Combine With | Use Case |
| ------------------ | ------------------------------------------------------------------------- |
| **Visual Editing** | Use CoView to explain complex changes, then fine-tune with Visual Editing |
| **Code Editor** | Record a bug demo, then review the AI's code fix in Code Editor |
| **Boost** | Use CoView for the initial request, Boost for quick iterations |
### Optimizing for Efficiency
CoView is optimized for accuracy, not speed. For simple, clear-cut changes, typing may be faster.
**When to type instead:**
* Simple text changes ("Change the button text to 'Submit'")
* Clear CSS values ("Make the header 64px tall")
* Code-only changes with no visual component
**When CoView saves time:**
* Anything that requires pointing ("this button", "that gap")
* Temporal issues (animations, loading states, transitions)
* Subjective feedback ("feels slow", "looks cramped")
## How CoView Works
CoView captures three layers of context and sends them to the AI together:
```
┌─────────────────────────────────────────────┐
│ CoView Input │
├─────────────────────────────────────────────┤
│ 🎥 Visual │ Screen recording frames │
│ 🖱️ Spatial │ Mouse position & movements │
│ 🎤 Voice │ Transcribed audio + tone │
└─────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────┐
│ AI Processing │
├─────────────────────────────────────────────┤
│ 1. Map voice to visual regions │
│ 2. Identify referenced elements │
│ 3. Understand temporal sequences │
│ 4. Generate targeted code changes │
└─────────────────────────────────────────────┘
```
### Why This Matters
Traditional text prompts lose context:
* **Ambiguity**: "The button" could be any button
* **Temporal blindness**: AI can't see animation timing from text
* **Spatial guessing**: "Top right" is relative and imprecise
CoView eliminates these issues by giving the AI the same visual context you have.
### Save Credits with Better Communication
Because CoView reduces miscommunication, you often get the right result on the first try:
| Approach | Typical Iterations | Credits Used |
| ---------------------------- | ---------------------------------------------- | ------------ |
| Text description (ambiguous) | 3-5 rounds of "not that button, the other one" | Higher |
| CoView (precise) | 1-2 targeted fixes | Lower |
Clear communication = fewer iterations = less credit consumption. CoView helps you get "What You See Is What You Get" fixes without burning through your quota on trial-and-error.
### Technical Notes
* **Permissions**: CoView requires browser permissions for screen recording and microphone access
* **Processing**: Longer recordings take more time to analyze—keep clips under 30 seconds when possible
* **Privacy**: Recordings are processed for the current request only and are not stored
## Good to Know
* Grant microphone and screen recording permissions when prompted
* Keep recordings focused—shorter clips process faster
* For code-only changes without visual context, typing is often more efficient
# Creator Studio
Source: https://docs.youware.com/features/creator-studio
Track project performance, earnings, and earnings withdrawals. Monitor your Creator Studio dashboard for revenue insights.
View your project performance, earnings, and revenue data in one place. Track views, credits spent by others on your projects, and manage withdrawals.
## Access Creator Studio
Click your avatar in the upper right corner → select **Creator Studio**
Creator Studio has two sections:
* **Dashboard** — project performance and metrics
* **Monetization** — earnings and withdrawal management
## Dashboard
View all your projects' performance data. Track how many people use your projects and how much credit they consume.
### Key Metrics
Total views across all your projects
Total Credits consumed by others using your projects
### Project Details
Each project shows:
* **Project name & publication date**
* **Credits Spent** — total Credits consumed
* **Times Used** — how many times invoked
* **Views** — number of visits
* **Built On / Saves** — times remixed or saved
## Monetization
Manage your earnings and withdrawals. View balance, transaction history, and request payouts.
### Account Overview
* **Account Balance**: Your current balance
* **Total Earnings**: Cumulative earnings
* **Withdrawn / Processing**: Withdrawal history
* **Request Withdrawal**: Initiate a payout (minimum \$50 USD)
### Transaction History
View all transactions with details: source, amount, payment method, status, and date. Updated daily.
## Frequently Asked Questions
Withdrawal timing depends on your payment method. Check your transaction history for status updates.
When someone else uses your project (generates with your project, remixes it, or runs any AI feature in it), that's when Credits are consumed.
Withdrawal methods depend on your region and payment provider integration. Check your account settings for available options.
No maximum. You can withdraw your entire balance as long as it's at least \$50 USD.
# Custom Domain
Source: https://docs.youware.com/features/custom-domain
Point your YouWare project to a branded domain. Configure DNS, SSL, and go live with your own URL.
Launch every YouWare project under your brand. Custom domains let you publish AI-built sites and apps on URLs your audience trusts.
## What Is a Custom Domain?
A custom domain is a unique website address that belongs to you or your organization. Instead of sharing a generic link, your project lives on a name that is personal, memorable, and brand-ready:
* `www.freshbrewcafe.com`
* `courses.byemma.com`
* `mychurchonline.org`
When you attach a custom domain, your AI-built website or app immediately looks professional the moment it goes live.
### Who Benefits Most
* Local businesses such as restaurants, salons, clinics, and retail shops
* Educators, coaches, and online course creators
* Churches, communities, and nonprofits
* Freelancers, agencies, and personal portfolios
* Any creator launching a public-facing product or service
## Connect Your Custom Domain
Publish your YouWare project just like any other launch.
Click **Custom Domain** in your project settings, then choose **Add Domain**.
Type the domain you own (from providers like GoDaddy, Cloudflare, Name.com, or similar registrars).
Copy the TXT and CNAME values displayed in the YouWare dashboard. These records verify ownership and route traffic.
Paste the records into your registrar's DNS settings exactly as shown.
Click **Verify** in YouWare and wait for propagation. Once complete, your project serves from your custom domain.
Propagation times vary. TXT records usually verify within minutes, while CNAME routing can take up to 24 hours depending on your provider.
### DNS Provider Examples
Use your registrar's dashboard to add the records:
* Cloudflare — supports root domain CNAMEs through CNAME flattening.
* Namecheap — provides dedicated CNAME record types for root and subdomains.
* GoDaddy, Alibaba Cloud, and other legacy registrars may require you to use `www` or another subdomain.
## Configuration Values
To connect your domain, add **two DNS records**. Copy the exact values from your YouWare dashboard for the project you are publishing.
### 1. Ownership Verification (TXT)
* Host: `_youware-verify`
* Value: (copy the TXT string from the dashboard)
* Purpose: proves you own the domain before traffic is routed
Most providers automatically append your domain to the host field. Only enter the full domain if your registrar explicitly requires it.
### 2. Traffic Routing (CNAME)
* Host: the hostname you want to use (for example `www`)
* Value: the CNAME target provided by YouWare
* Purpose: points traffic from your domain to YouWare's infrastructure
A CNAME record must be the only record for that hostname. Remove any conflicting A or AAAA records before saving.
## Unable to Connect to Your Domain?
Standard DNS rules do not allow a CNAME record on the root domain (for example, `yourbrand.com` purchased from GoDaddy). Work around the limitation in one of two ways:
* **Option 1: Use a subdomain**\
Create a CNAME for `www.example.com`. Set up URL forwarding from the root to `www` if needed.
* **Option 2: Switch DNS to Cloudflare (Recommended)**\
If you must use the root domain (`example.com`), we highly recommend switching your DNS management to Cloudflare (it's free).
1. Create an account at [Cloudflare.com](https://www.cloudflare.com/).
2. Add your domain and follow the instructions to change your nameservers.
3. Once active, you can add a CNAME for `@` directly without errors.
📘 **Detailed Guide:** [How to set up Cloudflare DNS](https://developers.cloudflare.com/dns/zone-setups/full-setup/setup/)
## Frequently Asked Questions
DNS propagation is not instant. TXT records typically verify within 10 minutes, while CNAME changes can take up to 24 hours. Double-check that your record values match the dashboard exactly.
For the TXT record, leave proxying off (grey cloud). For CNAME records you can enable the orange cloud to leverage Cloudflare. If verification stalls, temporarily turn it off and retry.
No. DNS standards block a CNAME from coexisting with other records on the same host. That is why YouWare uses `_youware-verify` for TXT verification—it keeps routing and verification separate.
Ensure there are no leftover A or AAAA records for the same host. Remove duplicates, then wait for DNS caches to expire.
## Need Help?
Still seeing issues after propagation? Email `support@youware.com` with:
1. Your custom domain (for example `www.example.com`)
2. A screenshot of your DNS records
3. The email tied to your YouWare account
We'll review your configuration and help you go live fast.
## Private Access (Passcode)
Custom domains aren't only for branding—they can protect access, too. Pair your domain with **Private Access (Passcode)** to require a passcode before anyone can view your site.
Perfect for:
* Internal dashboards and tooling
* Paid courses or premium lessons
* Client deliverables and work-in-progress demos
* Church groups, schools, or invitation-only communities
Publish publicly, share privately, and still keep everything under your own URL.
## Our Vision Forward
Custom domains are part of a bigger mission: everyone should be able to turn an idea into a working product with AI—complete with a professional, trustworthy presence. Build with YouWare, launch under your brand, and share your story with the world.
***
**Custom domains are available on Pro and Ultra plans.** Launch your project under your own brand today.
[View Plans & Pricing →](https://www.youware.com/subscription?location=docs)
# History - Rewind Any Change
Source: https://docs.youware.com/features/history
Made a mistake? No problem. History lets you jump back to any version of your project instantly—no stress, no lost work.
**Undo on steroids.**
Every change you make is saved automatically. Rewind to any version anytime—your work is always safe.
## Why History Matters
You're building. Experimenting. Trying bold ideas.
Then something breaks. Or you realize the version from 10 minutes ago was actually better.
**History has your back.** Every edit, every AI generation, every tweak—automatically saved as a new version. You can jump back to any moment with one click.
No lost work. No panic. Just confidence.
## How It Works
Click the **History icon** in the top toolbar (looks like a clock).
See your project's timeline. Each version shows what changed and when.
Click a version to preview it instantly. See exactly what your project looked like at that moment.
Found the version you want? Click **Restore this version**. Done.
**Important: Restoring is permanent.**
Once you restore a version, **all versions after it are gone**. You won't be able to access anything that happened after that point.
Example: If you restore Version 20, you lose Versions 21, 22, 23, and everything after.
**Credits are not refunded** when you restore. Use [Credit Care](/introduction/youware-credit-care) if you want to refund credits from a failed attempt.
Preview carefully before restoring. Make sure it's the exact version you want—there's no undo for this action.
## When to Use History
AI went in the wrong direction? Rewind to before it happened.
Preview multiple versions side-by-side to pick the best one.
Accidentally deleted something? Find the version before the mistake.
Try wild ideas. If they don't work, just rewind. Zero risk.
## What Gets Saved
Every version captures:
* All code changes
* Visual edits you made
* AI-generated updates
* Manual file edits
Each version includes:
* **Description** — What changed
* **Timestamp** — Exactly when it happened
* **Full snapshot** — Complete state of your project
## Pro Tips
You don't need to do anything. Every time you make a change or the AI generates something, a new version is created instantly.
Your history stays forever. Come back weeks later and find any version.
**Critical:** Preview the version first. Once you restore, everything after that version is permanently lost. There's no undo.
Restoring doesn't refund credits. If you want to recover credits from a failed attempt, use [Credit Care](/introduction/youware-credit-care) to rewind AND get your credits back.
***
## Build Without Fear
History means you can try anything. Break things. Go bold. Experiment freely.
Because you can always rewind.
**Your safety net is always on.** Every version is saved. Every change is reversible. Create fearlessly.
***
**Need help?**
Can't find a specific version? Contact support—we can help you locate it.
# YouWare Mobile
Source: https://docs.youware.com/features/mobile
Create and manage projects on your phone. Build, edit, and publish directly from the YouWare mobile app on iOS or Android.
Build complete projects on your phone. Create, edit, and manage your work with the full YouWare experience.
## Download the App
Search **"YouWare"** in the App Store
Search **"YouWare"** in Google Play
## App Screenshots
## What You Can Do
Start new projects directly on your phone using voice or text prompts
Modify your projects with chat, visual editing, or code view
Get updates when AI tasks complete, even while using other apps
Start on phone, continue on desktop. All data syncs in real-time
**Push Notifications Advantage**: Tasks run in the background while you do other things. Get notified instantly when they're done—no need to keep checking the app. Perfect for quick iterations while on the go.
## Mobile Features
### Voice Input
Describe your project idea using your voice. The AI builds it immediately. No typing required.
### Photo Integration
Snap a photo or upload an image. The AI can use it as a reference for your project.
### Task Notifications
Get notified when background tasks complete. Check your Recent Tasks tab to see what's done and what needs attention.
### iOS Improvements (Latest Update)
* **Better Notifications**: Recent Tasks now shows clearer status for ongoing and completed projects
* **Faster Search**: Upgraded search for quicker project discovery with better accuracy
* **Reliable Notifications**: Push notifications deliver more consistently across your devices
### Cross-Device Workflow
Start a project on your phone and continue on your desktop. When desktop tasks finish, your phone gets notified automatically. All changes sync in real-time.
## Frequently Asked Questions
Most important features work on mobile: create projects, edit code, visual editing, and publish. Some advanced features are desktop-only due to screen size, but everyday work flows smoothly on phone.
Yes. Projects save automatically as you make changes. All data syncs to your account and other devices in real-time.
Yes. Go to app settings and toggle push notifications on or off. You can control notifications per project if you prefer.
Yes. You can browse and edit code directly in the mobile app, with the same syntax highlighting as desktop.
Yes. Your credit balance is shared across all devices. Credit usage is the same whether you generate on mobile or desktop.
The app works on any modern smartphone. For best experience, use a phone with a 5-inch or larger screen.
Yes. You can remix any public project directly from the mobile app and modify it with text prompts.
No. YouWare Mobile requires internet connection to create and edit projects. Data syncs when connection is available.
# Multi-Model Switching
Source: https://docs.youware.com/features/multi-model-switching
Switch between 5 top AI models (OpenAI, Anthropic, Moonshot, Z.ai) to optimize efficiency and costs for different tasks. Choose the right model for each scenario.
For the same requirement, it takes 20 points with Claude and 5 points with GLM. But Claude can handle complex tasks at once, GLM may need to debug 3 times.
**Model selection directly determines your efficiency and cost.** YouWare now integrates 5 top AI models, from OpenAI and Anthropic to Moonshot and Z.ai - you can switch at any time in the bottom right corner of the input box to match the task to pick the right tool.
## Why Multiple Models Matter
**A single model can't fulfill all scenarios:**
Don't need the most intelligence, but are burning the most expensive points
Require top-level reasoning, and weak models will repeatedly make mistakes
Small context windows truncate key information when processing
When one model's service breaks, all projects are stuck
## Model Matrix Flexibility
Low-cost models for fast iteration
Top models for quality assurance
Large context windows for complete processing
Automatic switching to available models
## How to Switch Models
Click the current model name (default "Claude Sonnet 4.5") in the lower right corner of the input box
Drop-down menu shows all 5 models
Hover to view detailed information card (speed, intelligence, cost, support capability)
Click on the target model and confirm switching on the right
## Model Information Cards
Each model information card provides comprehensive decision-making data:
5-panel progress bar comparison for Speed and Intelligence levels
Clear cost levels: Low, Standard, or Max pricing tiers
Token limits and corresponding word count estimations
Capability tags including Web Search, MCP, and Vision support
Switching between models is instant and takes just 3 seconds to complete. Choose the optimal model based on your specific task requirements and budget constraints.
# Remix
Source: https://docs.youware.com/features/remix
Copy and modify an existing project. Change content, theme, or add sections directly from the Remix popup.
Click the **Remix** button on any project to create a copy and modify it. You can change images, text, colors, layout, and add new sections without starting from scratch.
## Start Remixing
1. Find a project you want to modify
2. Click the **Remix** button on the project details page
3. The Remix popup opens with modification options
4. Make your changes and click to apply
## Quick Modification Prompts
Enter what you want to change directly in the text input. Examples:
* "Replace the hero image with a video"
* "Change the color scheme to blue and white"
* "Add a pricing table"
* "Make the buttons larger"
* "Change the background to dark"
## Preset Options
For common changes, click one of these buttons:
Update images or text
Modify colors or layout
Add new components
## What Remix Saves You
* **No rebuilding**: Reuses existing code and structure
* **Lower cost**: Fewer Credits than creating from scratch
* **Faster edits**: Modify only what you need to change
## Frequently Asked Questions
No. When you remix a project, you create a completely independent copy. The original project remains unchanged. Your remixed version is your own separate project.
No. You can remix using natural language prompts like "Make the buttons bigger" or "Change the background color." No coding required.
Yes. You can remix any public project, including projects that were already remixed from other projects. Each remix is a new, independent copy.
Remixing itself is free. You only pay Credits when you ask the AI to make modifications to your remixed copy.
You can only remix projects that are publicly shared. Private projects cannot be remixed.
Yes. Your remixed project displays credit to the original creator and links back to the original project on the project details page.
Creating the copy is instant. Making modifications takes a few seconds depending on complexity. You can see live updates as changes are applied.
Yes. You can request new changes or edit your remix copy to revert modifications. The original project is never affected.
If a project creator has disabled the remix option (marked "Remix Permissions: Off"), you cannot remix that project. The remix button will be disabled and cannot be clicked. Only projects with remix enabled can be remixed.
No. Projects created through remix cannot be downloaded as source code. This protects the original creator's work. If you need to download code, create a project from scratch instead.
No. If remix is disabled, the project becomes read-only. Other users can view it but not modify or copy it.
No. If you allow remix, anyone can create unlimited copies from your project.
Yes. Remixed projects link back to the original, so you can see remixes in your Creator Studio analytics.
# Share & Publish Projects Online
Source: https://docs.youware.com/features/share
Publish your project and generate a shareable link. Control who can see and remix your work.
Publish your project to get a shareable link. You control access, descriptions, and remix permissions.
## Publishing
Click the **Publish** button in the top-right corner of your project
Click the **Share** button to get your project link
Your project generates a unique link that you can share with anyone.
## Your Project Link
After publishing, your project gets a standard link showing the work and description.
### Auto-Generated Description
When you share a project, a short description is automatically created based on your project content.
## Mobile App Integration
When someone opens your shared link in the YouWare mobile app, they go directly to the project details page. This gives them quick access to your work with one tap, and they can remix it if you've allowed it.
## Privacy & Sharing Settings
Privacy and Remix settings are available on [paid plans](https://www.youware.com/subscription?location=docs) only.
Click **Settings** to control who can access and modify your project:
Require a four-character password to access. The system generates one automatically, and you can share it with whoever you choose.
Allow or disable other users from remixing (copying and modifying) your project. When disabled, it becomes read-only.
Hide the YouWare branding badge from your published project for a cleaner, more professional look.
## Frequently Asked Questions
No. Your project link stays active as long as your project is published. If you unpublish it, the link becomes inactive.
No. The description is automatically generated when you share your project. To control what others see, you can make the project private or delete it.
Views are tracked in your Creator Studio dashboard. You can see total views and how many people have used your project.
Click the **Unpublish** button to make your project private again. The shared link will become inactive immediately.
Yes, if you're on a [paid plan](https://www.youware.com/subscription?location=docs). Go to **Settings** and enable **Private Projects** to add password protection. Existing links will still work, but viewers will need the password.
# Tab Tab Prompt Completion
Source: https://docs.youware.com/features/tab-tab-completion
Type faster with intelligent autocomplete. Tab Tab predicts your next command and keeps your creative flow uninterrupted.
**Type less. Create more.**
Tab Tab anticipates what you need next. Just press Tab — the suggestion fills in instantly.
## What Is Tab Tab?
Tab Tab is YouWare's intelligent autocomplete for your input field.
It reads your typing. Understands your intent. Suggests what comes next. No pause. No thinking. Just flow.
## How It Works
Type in the input field. Tab Tab analyzes your text and project context in real-time.
Smart predictions appear automatically based on what you're building.
Hit **Tab key**. The suggestion fills in instantly.
Don't like it? Keep typing. Tab Tab adjusts immediately with new suggestions.
Tab Tab learns from your project context. The more you build, the smarter the suggestions.
## Why It Helps
Stop thinking about syntax. Let AI complete your thoughts.
No pause. No interruption. Ideas turn into commands instantly.
Suggestions adapt to your project, tech stack, and current task.
Discover new possibilities through AI suggestions you hadn't considered.
## When to Use Tab Tab
**Perfect for:**
* Quick iterations and rapid prototyping
* Complex prompts that need precise descriptions
* Learning new YouWare commands and capabilities
* Maintaining creative momentum during long sessions
**How it adapts:**
* Building a landing page? Tab Tab suggests layout improvements
* Working with animations? It recommends motion libraries
* Adding features? It predicts common next steps
## Best Practices
Tab fills in the suggestion. Review it before hitting Enter. You can always edit before submitting.
If the suggestion isn't quite right, don't stop. Keep typing and Tab Tab will adjust its prediction instantly.
When doing similar edits, Tab Tab remembers patterns. It speeds up repetitive work significantly.
Use Tab Tab with Boost, Visual Editing, or Code Editor. It works everywhere in the editor to keep you moving fast.
***
**Available everywhere**
Tab Tab works on the creation page and in the editor. Start typing anywhere to see suggestions.
# Visual Editing - Direct UI Modifications
Source: https://docs.youware.com/features/visual-editing
Edit website elements directly in the preview with instant visual feedback. Make precise UI changes without describing them to AI, saving time and credits while maintaining full control.
**Direct, Precise, Instant** — Skip the back-and-forth. Select elements on screen, edit them visually, and apply changes instantly. Visual Editing empowers you to iterate faster while using fewer AI credits.
Visual Editing transforms the way you build. Instead of describing UI changes to AI, you select elements directly in the preview, adjust them visually, and see results in real-time. Perfect for fine-tuning layouts, updating text, swapping images, or refining interactions—all without consuming extensive AI resources.
## Why Visual Editing Matters
Make changes in seconds, see results instantly. No waiting for AI responses.
Visual modifications consume minimal credits compared to descriptive edits.
Select exactly what you want to change. No ambiguous descriptions needed.
See every adjustment update in real-time as you modify elements.
## Getting Started
Click the **Edit** button in the bottom-left corner of the chatbot to activate Visual Editing mode
Hover over the element you want to modify, then click to open the editing toolbar
Use the available tools to adjust text, images, styling, or properties
Click the send arrow or press Enter to apply your edits and exit Visual Editing mode
## Editing Different Elements
### Text Elements
Click directly on any text to edit its content. The toolbar provides comprehensive formatting options:
Adjust **font size**, **color**, **style** (bold, italic, underline), and **text alignment**. Add hyperlinks to make text interactive.
Modify **padding** and **margin** to control space around text elements and their positioning.
### Image Elements
Select any image to replace or customize it:
Upload a new image file (PNG, JPG, SVG, WEBP, GIF) to replace the selected image instantly.
Adjust **corner radius** for rounded corners, control **padding** and **margin**, or add **hyperlinks** for interactivity.
### Other Elements (Divs, Buttons, Spans, etc.)
Customize styling and interactivity for any page element:
Modify **corner radius**, **padding**, **margin**, or **background color** to match your design vision.
Add **hyperlinks** to make any element clickable, turning static elements into interactive components.
Delete elements you no longer need with a single click. The element is removed from your page immediately.
## Keyboard Shortcuts
Speed up your workflow with these keyboard shortcuts:
* **Cmd+Z** — Undo your last change
* **Shift+Cmd+Z** — Redo your last change
* **Ctrl+Z** — Undo your last change
* **Ctrl+Shift+Z** — Redo your last change
## Applying & Saving Changes
**Important**: Changes are only saved when you apply them. Unsaved modifications will be lost if you exit without applying.
When you're ready to finalize your edits:
Take a moment to review all modifications in the preview
Click the **send arrow** or press **Enter** to apply your edits and exit Visual Editing mode
View the credit cost displayed after each edit (for example: `Credits used: 20`). Depending on change complexity, some edits may consume no credits at all.
## Exiting Visual Editing
You have two options when leaving Visual Editing mode:
Click the **send arrow** or press **Enter** to save your edits and exit Visual Editing mode. Your changes become permanent.
Click the **Edit** button again in the bottom-left corner. In the popup menu, select **Discard changes** to exit without saving any modifications.
## Best Practices
**Pro tip**: Use the undo/redo shortcuts (Cmd+Z / Ctrl+Z) liberally. You can experiment freely and revert any mistakes instantly without affecting your AI credit balance until you apply changes.
Visual Editing works best for targeted, precise modifications rather than complete redesigns.
Make multiple related changes before applying to optimize credit usage.
Always review changes in the preview before applying them to avoid unintended modifications.
Use Visual Editing for refinements and AI chat for structural changes to your website.
## Summary
Visual Editing transforms "slow, credit-heavy back-and-forth" into "**quick, precise, and affordable**" improvements you fully control. By selecting elements directly in the preview, you eliminate misunderstandings, shorten feedback loops, and keep projects moving forward.
Whether you're polishing copy, swapping images, fine-tuning layouts, or adding interactivity, you can iterate in seconds and apply changes confidently—no guesswork, no waste.
# FAQ
Source: https://docs.youware.com/introduction/faq
Comprehensive FAQ covering YouWare's AI coding features, project templates, full-stack development, publishing, and Pro features. Start building faster today.
Welcome to YouWare! We've built YouWare to be the fastest, most intuitive way to build and publish web applications. This comprehensive FAQ covers everything from core features to advanced development workflows.
## Getting Started: Your First Project
We recommend heading straight to the "Create" button. You have two main paths:
1. **Start with a simple prompt**: Describe your idea in natural language to the AI and watch it come to life.
2. **Use a Template**: Browse curated project templates and community recommendations to kickstart instantly.
Our template library is constantly expanding! Need inspiration? Check out the "Explore" page to see what other creators are building and trending projects.
A "remix" lets you instantly copy another creator's public project to your own workspace. Think of it as **making your own version of someone else's work**—like taking a recipe and adjusting it to your taste.
**What you get:**
* Full, editable copy in your workspace
* Learn from and modify existing work
* Build upon others' projects safely
* Original project remains unaffected
Creators can manage and share their templates through the **Creator Studio**.
You can manage these settings within the project editor. Look for the "Setting" menu, typically located in the top-left corner of the interface. This menu provides options to update the project title and select a new cover image for better organization and presentation.
No, creating a project from others' project is free. Credits are only deducted when you formally input a query and the AI executes a task (i.e., generates or modifies code).
You are charged for the computational resources used by the AI Agent, not for simply copying a template. We also offer Credit Rewards for platform participation and task completion.
## Core Development & Features
Once YouWare generates your initial project, you have **three powerful ways** to refine and edit it:
### 1. Chat with AI (The Conversational Editor)
The most powerful way to refine your project. Simply tell the AI what you want to change using natural language. The AI remembers the context of your entire project and can execute complex changes instantly.
**Examples:**
* "Add a dark mode toggle to the header"
* "Make the 'Submit' button more prominent and change its color to red"
* "Connect this form to a new database table called UserFeedback"
### 2. Visual Editing (The No-Code Layer)
For quick style tweaks and content changes. Click any element in the preview (e.g., a button, a text block, an image) and make direct visual adjustments without writing code. Perfect for rapid prototyping and design iterations.
### 3. Code Editor (The Developer's Playground)
For deep customization with full access to your project's complete code:
* **Browse Your Project Structure**: Explore all generated files directly inside the workspace
* **Edit & Save Instantly (Subscribers)**: Make changes to any file with instant preview reflection
* **Cleaner, Faster Workflow**: The redesigned interface makes development more intuitive
All three methods work seamlessly together, allowing you to choose the approach that best fits your workflow and expertise level.
Just prompt the AI with a clear description of what you need. Be specific!
**Examples:**
* "Create a product landing page for an AI-powered tool, using a clean, modern design."
* "Add a sticky navigation bar with three links: Home, Features, and Pricing."
Yes! **YouBase** is YouWare's built-in backend infrastructure that provides everything you need for full-stack development:
| Module | Description |
| -------------------------- | -------------------------------------------------------------- |
| **Users & Authentication** | Email login, Google OAuth, temporary accounts, user management |
| **Database** | Create tables, store and query data with simple prompts |
| **Storage** | File uploads and media management |
| **Secrets** | Secure API key and configuration storage |
### How to Use
YouBase is integrated into every YouWare project. Simply describe your backend needs to the Agent:
* *"Add user login to my app"*
* *"Create a database table for storing user feedback"*
* *"Let users upload profile pictures"*
### Publishing
One-click publishing makes your project live with a shareable URL instantly.
Explore the complete YouBase documentation for detailed guides on each module.
**Important Security Note**: If you integrate external APIs without using YouBase Secrets, there is a **risk of API key exposure** in your front-end code.
**YouBase Secrets**: Store your API keys securely in YouBase Secrets. They are never exposed in the front-end code.
**Best Practice**: For sensitive API integrations, always use YouBase Secrets to store API keys securely, rather than exposing them in client-side code.
Yes, code visibility and ownership are core to our professional ethos.
**Viewing Code**: You can inspect the generated code at any time within the editor. Full transparency guaranteed.
**Downloading Code**: This is a YouWare Pro exclusive feature, designed for professional users who need to integrate their work into external development tools or hosting platforms.
To protect community creators, code download is only available for projects you created from scratch (non-Remix projects).
## Advanced Workflow & Troubleshooting
Think of the AI as a highly skilled, but literal, colleague. The key to great results is to be **Clear, Specific, and Contextual**.
### Golden Rules from Prompt Craft
1. **Start with the Feeling, Not the Features**: Describe the *vibe* you want (e.g., "cozy, rainy-day bookstore" vs. "three-column layout")
2. **Tell a Story**: Structure your site like chapters—Hook, Why, Proof, Invitation
3. **Sculpt, Don't Command**: Treat prompting as a conversation. Refine piece by piece.
**Examples:**
* ❌ "Make a landing page for a fitness app"
* ✅ "The vibe should be energetic and motivating, but not intimidating. Think bright colors, bold fonts, and a feeling of momentum."
Check out the [Prompt Craft](/prompting/prompting) guide for a complete masterclass on talking to AI like an art director, not a mechanic.
TabTab is your efficiency booster. While you are typing a prompt, press the **Tab key** to trigger an AI-powered auto-complete suggestion. It helps you articulate complex commands faster and discover new ways to interact with the tool.
As a professional tool, we encourage you to use standard web development diagnostics:
* **Browser Console (F12)**: Press F12 to open your browser's developer console. This is your first line of defense to distinguish between client-side and platform-side errors
* **Error Messages**: If the project fails to run, the system will provide a specific error message. Read it carefully and cross-reference with our documentation
A **500 error** is typically a server-side issue. First, try refreshing the page or starting a new chat session.
If the problem persists, please email us immediately at [**support@youware.com**](mailto:support@youware.com) with:
1. The project link
2. A screenshot of the error message (and the F12 console if possible)
If you hit a capacity limit, it means our servers are temporarily under high load. We're scaling up rapidly! Please try again in a few minutes.
## YouBase — Backend & Full-Stack Development
**YouBase** is YouWare's built-in backend infrastructure. It provides four core modules:
* **Users & Authentication**: Email login, Google OAuth, temporary accounts, and user management
* **Database**: Create tables, store data, and query records with simple prompts
* **Storage**: Upload and manage files (images, documents, media)
* **Secrets**: Securely store API keys and sensitive configuration
YouBase is a unified, self-developed solution—auth + database + storage + secrets all working together seamlessly. No external services required.
Simply describe your needs to the Agent. YouBase handles the implementation automatically.
**Example prompts:**
* *"Add user login with email and Google"*
* *"Create a database table for blog posts with title, content, and author"*
* *"Let users upload profile pictures"*
* *"Store my OpenAI API key securely"*
**Example:** Create a voting app by describing: *"Create a voting app with user login. Store poll options and vote counts in the database. Show real-time results."*
Yes! While YouBase is the recommended default (zero configuration, works instantly), you can also connect **Supabase** via MCP by providing valid access keys and describing your data goals to the Agent.
**Recommendation:** Use YouBase for most projects—it's simpler and fully integrated. Use Supabase if you need specific features or prefer external control.
Build real-time polls where results update instantly. Store vote counts and voter IDs, automatically calculate percentages.
Create competitive scoreboards with automatic ranking calculations. Display real player names from user accounts.
Add comment sections with persistent storage. Show real user profiles instead of "Anonymous User."
Store quiz questions, user answers, and scores. Track progress across sessions.
Member-only areas with personalized experiences. Store user preferences and history.
YouBase uses your regular Credits. The cost depends on your usage:
* **Database reads/writes**: Small credit cost per operation
* **Storage**: Credits for file storage
* **Authentication**: Included with database operations
You get a generous free tier to start building before any costs apply.
## Integrations & External Services
**MCP Tools** are like apps for your website. Install one, and your project connects to services you already use—ChatGPT, Figma, Notion, GitHub, and more.
**To add an integration:**
1. Click the **MCP icon** in the sidebar
2. Browse available tools (Figma, Notion, GitHub, etc.)
3. Enable the tools you want
4. Describe what you need in natural language
**Examples:**
* "Pull my latest Notion pages and display them here"
* "Convert my Figma design into a live webpage"
* "Connect to ChatGPT for real-time conversations"
**AI API is no longer available for new projects.** Projects created after the YouBase launch (December 16, 2025) cannot enable AI API. Existing projects using AI API will continue to work normally.
For new projects, use **YouBase Secrets** to securely store your own API keys (OpenAI, Anthropic, etc.) and call AI models from your backend code.
Store API keys securely and integrate AI models in new projects.
Yes! The **GitHub Integration** allows you to:
* Connect to your GitHub project for automatic backup and history tracking
* Let the AI read your existing code to understand your style and project structure
* Generate code that perfectly matches your existing work
* Enable team collaboration with code reviews and task tracking
**Setup:** Generate a GitHub Personal Access Token, add the integration, and the AI will understand your entire project context.
**Security Risk**: API keys exposed in front-end code can be compromised.
**Best Practice**: Always use **YouBase Secrets** to store API keys securely. This keeps sensitive credentials safe and prevents exposure in client-side code.
## AI Models & Optimization
YouWare integrates **5 top AI models**. Here's how to choose:
| Task | Recommended Model | Why |
| --------------------- | ----------------- | ------------------------------------- |
| **Complex reasoning** | OpenAI O3 Pro | Deep thinking for hard problems |
| **General tasks** | OpenAI GPT-4o | Reliable, versatile workhorse |
| **Creative writing** | Claude Sonnet 4.5 | Excellent for copywriting and content |
| **Technical Q\&A** | Gemini 2.5 Pro | Structured thinking for precision |
| **Budget-conscious** | DeepSeek V3 | Cost-effective all-rounder |
| **Speed matters** | Claude Haiku 3.5 | Ultra-fast, low-cost |
**Pro tip:** Switch models mid-project. Use a cheap, fast model for drafts, then switch to a powerful model for final quality checks.
Click the current model name (bottom-right of input box)
Hover over each model to see speed, cost, intelligence, and context window
Click your choice and confirm. Switching takes \~3 seconds.
Each model card shows:
* **Speed & Intelligence ratings** (5-panel comparison)
* **Cost tier** (Low, Standard, Max)
* **Context capacity** (token limits)
* **Feature support** (Web Search, MCP, Vision)
| Model | Best For | Quality | Speed | Cost |
| ------------------- | --------------------------------- | -------- | ------ | -------- |
| **Midjourney** | Professional art, diverse styles | High | Medium | Standard |
| **GPT-Image-1** | Product visuals, polished designs | High | Medium | Standard |
| **Gemini Imagen 4** | Clear text rendering, consistency | High | Medium | Standard |
| **Flux AI** | Fast turnaround, basic needs | Standard | Fast | Low |
**Pro tip:** Use Flux for quick drafts, Midjourney for artistic work, GPT-Image-1 for product mockups.
## Editing & Creation Tools
**Visual Editing** is perfect for rapid tweaks. Instead of describing changes to AI:
1. Click the **Edit** button
2. Click any element on screen
3. Adjust text, colors, spacing visually
4. Changes apply instantly
**Benefits:**
* Instant results (no waiting for AI)
* Minimal credit cost
* Pixel-perfect control
Use Visual Editing for style tweaks, then use AI Chat for major structural changes.
**Tab Tab** is YouWare's intelligent autocomplete for your input field:
* **Type** your prompt and Tab Tab analyzes your input in real-time
* **Press Tab** to accept AI-suggested completions
* **Keep typing** if the suggestion isn't right—it adjusts instantly
**Benefits:**
* Type faster with smart predictions
* Discover new ways to phrase commands
* Stay in creative flow without pausing
Tab Tab learns from your project context. The more you build, the smarter the suggestions become.
Use **History** to jump back to any previous version:
Click the **History icon** (clock) in the top toolbar
See your project timeline with descriptions and timestamps
Click any version to preview it instantly
Found the right version? Click **Restore this version**
**Important:** Restoring is permanent. All versions after the restored point are lost forever. Preview carefully before restoring.
History doesn't refund Credits. If you want Credits back, use [Credit Care](/introduction/youware-credit-care) instead.
**Credit Care** is your safety net for AI experiments:
* **Monthly Credit Restores**: Get chances to rewind failed attempts and recover Credits
* **Free Plan**: 1 restore/month
* **Pro Plan**: 30 restores/month
* **Ultra Plan**: 100 restores/month
**How to use:**
1. Click **Rewind to previous version** on your commit
2. Select **Rewind & refund credits**
3. Credits return instantly to your balance
**Key difference from History:**
* **History**: Rewind project, no Credit refund
* **Credit Care**: Rewind project AND get Credits back
Zero-cost commits (manual code edits, UI tweaks) don't count toward your monthly limit—rewind those freely!
**Boost** automatically analyzes and optimizes your page with one click. The AI examines:
* **Page Structure**: Layout and visual hierarchy
* **Content Quality**: Text clarity and information flow
* **User Experience**: Interface and interactions
Then it enhances your page while preserving your original design intent. No prompts needed—it's fully automated.
Use Boost when your page feels rough but you're not sure what needs improvement.
**Yes!** Use **Code Editor** to:
* Browse your complete project structure (HTML, CSS, JavaScript, JSON, etc.)
* View code (all users)
* Edit and save instantly (subscribers only)
* See real-time updates in preview
**Pro tip:** Mix manual code edits with AI changes. The AI remembers your manual edits and considers them in future modifications.
| | **Create** | **Remix** |
| ------------------ | ------------------------------ | --------------------------------- |
| **Starting point** | Blank canvas or template | Existing public project |
| **Cost** | Full credits for new code | Lower credits (reuses structure) |
| **Use case** | Original ideas | Modify existing work |
| **Speed** | Longer (building from scratch) | Faster (changing existing design) |
| **Can download?** | Yes (Pro only) | No (protects original creator) |
**Pro tip:** Remix to learn from existing projects or to save credits on variations.
## Cross-Platform & Sharing
**Yes!** The **YouWare Mobile App** lets you:
* Create new projects with voice or text prompts
* Edit code and design (Code Editor + Visual Editing)
* Get push notifications when tasks complete
* Sync seamlessly with desktop
**Download:** Search "YouWare" in App Store (iOS) or Google Play (Android)
**Key features:**
* Voice input for hands-free creation
* Background task notifications
* Real-time cross-device sync
Click the **Publish** button in top-right corner
Click **Share** to generate a shareable link
Optional: Make private (add password) or disable remix
**Share modes:**
* **Standard link**: Shows project + YouWare header + description
* **Fullscreen link**: Shows only your project (for demos, embedding, portfolios)
**Privacy options:**
* **Public**: Anyone with link can access and remix
* **Private**: Requires password to view
* **No remix**: Others can view but not copy
**By default, yes.** Others can:
* Create a complete independent copy
* Modify it with natural language prompts
* Publish their own remixed version
**To prevent remixing:** Go to Share Settings and toggle **Remix Permissions: Off**. Your project becomes read-only.
**Note:** Code downloads are only allowed for projects created from scratch (non-Remix projects) and only for Pro subscribers.
## Tech Stack & Developer Tools
**YouWare uses React as the default for 0-1 creation.** Here's why:
### Why React by Default?
* **Better Results**: React's component architecture helps AI generate more organized, maintainable code
* **Modern Stack**: Industry-standard framework used by professional developers
* **Dynamic Features**: State management and interactivity work seamlessly out of the box
* **Reusable Components**: Easier to iterate and scale your project
### When to Use Each Mode
| | **React Mode (Default)** | **HTML Mode** |
| ------------------ | ----------------------------------------- | ---------------------------------- |
| **Best for** | Full apps, dashboards, interactive sites | Simple landing pages, static sites |
| **AI Performance** | Better structure, cleaner code generation | Straightforward, minimal setup |
| **Switching** | Default for new projects | Type `/html_mode` to switch |
| **Learning curve** | Modern framework (AI handles complexity) | Simpler, traditional approach |
**Good news:** You don't need to know React to use YouWare! The AI handles all the technical details. Just describe what you want in plain language.
**Pro tip:** Stick with React for most projects—the AI generates better results. Only switch to HTML if you specifically need a minimal static site.
## Planning & Optimization Tools
**Plan Mode** (`/plan`) is for organizing ideas *before* execution. It lets you:
1. **Outline your vision**: Describe what you want to build
2. **Organize steps**: Break complex projects into manageable phases
3. **Get structured planning**: The AI helps you think through your approach
4. **Then build**: Once your plan is solid, execute step by step
**Best uses:**
* Complex multi-step projects (e-commerce sites, dashboards)
* Team collaboration (align on approach before coding)
* Exploratory phases (brainstorm without committing to execution)
**Benefit:** Lightweight planning prevents wasted edits and keeps early brainstorming efficient.
**Yes!** The **Stop button** lets you:
* Interrupt ongoing generation immediately
* Save time and Credits
* Maintain full control of your workflow
Just click the **Stop** button during any active task. This is especially useful if you realize mid-generation that you want to change direction or if a task is taking longer than expected.
## Creator Economy & Growth
**Credit Rewards** let you earn through community participation:
* **Share Projects**: Earn Credits when others engage with your shared work
* **Invite Friends**: Receive Credits when people join YouWare through your referral
* **Community Engagement**: Participate in challenges and events for bonus Credits
Credits earned can be used immediately for:
* Generating new projects
* Running AI tasks
* Accessing premium features
Every share and invite builds your creator reputation while directly supporting your creative work.
The **Affiliate Program** lets creators earn by referring others to YouWare:
**How it works:**
* Share your unique referral link with your audience
* Earn rewards when people sign up through your link
* Track performance in the affiliate dashboard
* Access marketing materials and resources
**Who should join:**
* Content creators and influencers
* Developers and educators
* Community leaders
* Anyone with an engaged audience
Visit the Affiliate Program landing page for detailed information and signup.
**Creator Studio** is for creators who want to monetize and analyze their work:
**What you get:**
* **Performance Dashboard**: View engagement metrics for published projects
* **Revenue Tracking**: See income generated from your projects
* **Analytics**: Understand which projects perform best
* **Withdrawals**: Earn and withdraw revenue directly
**Who qualifies:**
* Creators publishing projects to the platform
* Users with publicly shared work
* Contributors to the YouWare ecosystem
**Access:** Reach out to support if you meet these criteria and want Creator Studio enabled on your account.
The **Creator Badge** shows on your profile and project pages. There are two types:
1. **Founding Creator**: For early YouWare community members who helped shape the platform
2. **Verified Creator**: Available as you build reputation and engagement
**Benefits:**
* Establishes credibility and recognition
* Increases visibility of your projects
* Shows community trust and participation
Badges are awarded based on your activity and contributions to the YouWare community.
## Account, Billing, and Community
The **Free version** provides full access to YouWare's core functionality—enough for you to explore, learn, and create smaller projects.
**YouWare Pro** is designed for power users and professionals. It unlocks:
* Code Download (for professional workflow integration)
* Larger Storage & Faster Processing
* Exclusive Templates & Project Recommendations
* Priority Technical Support
You can decide to upgrade based on your usage frequency and need for advanced features.
We offer two options:
1. **Cancel Auto-Renewal**: Go to your Profile → Pro → Manage Subscription to prevent future charges
2. **Request a Refund**: Email your reason and account email to [support@youware.com](mailto:support@youware.com)
We urge you to double-check before confirming any deletion. Currently, deleted projects **cannot be recovered**.
We are working on adding a robust version history and recovery feature, but for now, please be careful!
We believe in a vibrant, supportive community. You can find help and connect with others through:
* **YouWare Help Center** (FAQ & Docs)
* [**Community Forum**](https://discord.com/invite/6fBAZ2tzfK): Ask questions, share knowledge, and collaborate
* **Direct Support**: Contact our customer support team for technical issues
# Glossary
Source: https://docs.youware.com/introduction/glossary
Complete glossary of essential terms for building AI-powered applications with YouWare. Learn key concepts from prompts and APIs to publishing and monetization.
# YouWare Platform Glossary
Your comprehensive guide to key terms for building AI-powered applications with YouWare. From core concepts to advanced technical terms, this glossary helps you navigate the platform with confidence.
***
## YouWare Fundamentals
* **Full-Stack Application** — An app that includes the frontend, backend, and data layer.\
*In YouWare:* Every project can be production-ready, not just a landing page.
* **MVP (Minimum Viable Product)** — The leanest version of your product that solves a real problem.\
*In YouWare:* Launch fast, learn from users, and iterate with AI instead of building infrastructure first.
* **AI API** *(Legacy)* — A YouWare-built application that exposes AI capabilities (chatbots, assistants, generators) via API.\
*In YouWare:* No longer available for new projects. Existing projects using AI API continue to work. For new projects, use [YouBase Secrets](/youbase/secrets) to store API keys and integrate AI models.
* **Credits** — The usage-based currency for AI generation, compute, and advanced services.\
*In YouWare:* Pay only for what you use. Credits fuel tasks like code generation, publishing, and model upgrades.
* **Remix** — Starting from an existing project and tailoring it to your needs.\
*In YouWare:* Duplicate any public build, tweak it, and ship your version instantly.
* **Tab Tab Prompt Completion** — Inline prompt suggestions that appear when you hit `Tab` twice.\
*In YouWare:* Finish prompts faster with context-aware completions that reduce typing.
* **Boost** — An AI-powered enhancement that polishes existing blocks or components.\
*In YouWare:* Quickly improve layout, copy, or visuals without rebuilding from scratch.
* **Visual Editing** — Point-and-click editing mode for adjusting layout, spacing, and styles.\
*In YouWare:* Make precise UI tweaks without writing CSS; perfect for fine-tuning generated pages.
* **Code Editor** — The full source editor with syntax highlighting and AI assistance.\
*In YouWare:* Jump into the code when you need granular control or want to add custom logic.
* **Creator Studio** — The workspace for managing projects, assets, and team members.\
*In YouWare:* Centralize everything related to your builds in one dashboard.
* **YouWare Backend** — Managed backend services for data, auth, and automation.\
*In YouWare:* Configure tables, triggers, and functions visually—no manual server setup required.
* **YouWare Credit Care** — Monthly Credit Rewinds that refund failed AI attempts.\
*In YouWare:* Experiment freely knowing misfires won’t permanently consume Credits.
***
## AI Concepts
* **Prompt** — The instruction you give the AI to describe what you want built or changed.\
*In YouWare:* Treat prompts like you’re briefing a full-stack teammate—clarity and detail unlock the best results.
* **Generative AI** — Technology that creates new content (text, code, images) from patterns it has learned.\
*In YouWare:* It powers every “describe it, ship it” workflow across the platform.
* **Context Window** — The amount of information an AI model can remember while responding.\
*In YouWare:* Long discussions stay on track because the AI keeps earlier instructions inside the window.
* **Prompt Engineering** — Crafting precise instructions that produce reliable AI outputs.\
*In YouWare:* The better your prompt, the fewer retries you need.
* **Token** — A slice of text the AI processes (roughly a word or part of a word).\
*In YouWare:* Complex requests that use more tokens may cost more Credits.
* **Hallucination** — When an AI generates output that’s incorrect or unsupported.\
*In YouWare:* Nudge the AI with a follow-up prompt or use Credit Care to rewind.
* **LLM (Large Language Model)** — The brains behind the responses, trained on massive datasets.\
*In YouWare:* Switch between models like GPT‑4, Claude, or Gemini depending on speed or fidelity needs.
* **Text-to-Image Generation** — Turning written descriptions into visuals.\
*In YouWare:* Generate custom artwork and UI assets through Image Generator or the AI API.
***
## Building Blocks & Workflow
* **Component** — A reusable chunk of UI such as a button, card, or form.\
*In YouWare:* Edit Components in isolation without breaking the rest of the page.
* **Block** — A larger section composed of multiple Components (hero, testimonials, pricing).\
*In YouWare:* Prompts often output Blocks you can rearrange or save as favorites.
* **Frontend** — Everything the user sees and interacts with in the browser.\
*In YouWare:* Generated with modern best practices, responsive by default.
* **Backend** — The logic layer that handles data, automation, and security.\
*In YouWare:* Auto-configured services manage auth, APIs, and workflows for you.
* **Database** — Structured storage for content, user data, or transactions.\
*In YouWare:* Manage data from the dashboard without writing SQL.
* **Publishing** — Making your project live and accessible on the web.\
*In YouWare:* One click to go from draft to live with a shareable URL.
* **IDE (Integrated Development Environment)** — A coding workspace with editor, tools, and previews.\
*In YouWare:* Use the browser editor to build and preview your projects.
* **Repository (Repo)** — The version-controlled home for your source code.\
*In YouWare:* Connect GitHub to sync every commit and collaborate safely.
* **Version Control** — Tracking changes so you can revert or review history.\
*In YouWare:* GitHub backup plus YouWare History keeps every iteration recoverable.
* **Tech Stack** — The languages, frameworks, and tools behind your project.\
*In YouWare:* Automatically configured based on your project type.
* **Authentication (Auth)** — Verifying users before granting access.\
*In YouWare:* Built-in auth handles sign-up, login, and sessions out of the box.
* **Edge Functions** — Serverless logic that runs close to the user for low latency.\
*In YouWare:* Use them for triggers like notifications, counters, or custom automation.
* **Real-time Updates** — Data that appears instantly without refreshing the page.\
*In YouWare:* Perfect for live dashboards, chat, and multiplayer experiences.
***
## Design & Experience
* **User Flow** — The path a visitor follows to accomplish a goal.\
*Why it matters:* Smooth flows keep users engaged and confident.
* **Responsive Design** — Layouts that adapt automatically to every screen size.\
*Why it matters:* Every YouWare project ships responsive by default.
* **Wireframe** — A low-fidelity layout to explore structure before visual design.\
*Why it matters:* Collect feedback early, then iterate with AI.
* **CTA (Call to Action)** — Copy or buttons that nudge users to take the next step.\
*Why it matters:* Clear CTAs drive conversions, so YouWare places them for you.
* **Pixel-Perfect** — Code that matches the design exactly, down to spacing and colors.\
*Why it matters:* Figma-to-code exports stay faithful to the original mock.
* **SVG (Scalable Vector Graphics)** — Vector images that stay sharp at any size.\
*Why it matters:* Icons and illustrations look crisp on every display.
***
## Integrations & Connections
* **API (Application Programming Interface)** — Rules that let software talk to each other.\
*In YouWare:* Connect services like payments, CRMs, or AI providers without manual plumbing.
* **MCP (Model Context Protocol)** — A standard for connecting AI agents to external tools.\
*In YouWare:* Enable MCP tools (Figma, Notion, GitHub, etc.) to extend your project instantly.
* **Integration** — Linking external services so data flows seamlessly.\
*In YouWare:* Toggle the integrations you need; YouWare handles auth and configuration.
* **API Key** — A secret identifier proving your app has permission to call an API.\
*In YouWare:* Stored securely so you don’t expose credentials in the frontend.
* **Personal Access Token (PAT)** — A scoped token that grants limited access to services like GitHub.\
*In YouWare:* Use PATs for integrations while keeping your main account secure.
* **OAuth** — A standard that lets users authorize apps without sharing passwords.\
*In YouWare:* Commonly used when connecting accounts like GitHub or Figma.
* **Credentials** — Any data (passwords, tokens) that proves identity.\
*In YouWare:* Managed and encrypted; never shipped to the client.
* **Scope / Permissions** — The specific actions an integration is allowed to perform.\
*In YouWare:* Grant just enough access—read-only, write, admin—to keep projects safe.
* **Rate Limiting** — API guardrails that cap how many requests can be made in a timeframe.\
*In YouWare:* Respect limits to avoid timeouts or throttling.
* **Web Scraping** — Programmatically extracting data from webpages.\
*In YouWare:* Use the Web Scraper tool to pull structured data for your apps.
***
## Data & Backend
* **CRUD** — Create, Read, Update, Delete—the four basic database operations.\
*In YouWare:* Build CRUD dashboards and tooling without writing boilerplate.
* **React** — A component-based JavaScript framework maintained by Meta.\
*In YouWare:* Default framework for 0‑1 creation because it yields organized AI-generated code.
* **HTML Mode** — Building with classic HTML/CSS/JS instead of frameworks.\
*In YouWare:* Ideal for lightweight landing pages or importing existing static sites.
* **Refactoring** — Improving code structure without changing features.\
*In YouWare:* Ask the AI to clean up, optimize, or modernize legacy codebases.
* **Framework** — A scaffold of libraries and patterns that speeds up development.\
*In YouWare:* Automatically configured based on your project requirements.
* **JSON (JavaScript Object Notation)** — A lightweight format for structuring data.\
*In YouWare:* The common language for APIs and data storage across your project.
***
## Growth & Reliability
* **SEO (Search Engine Optimization)** — Techniques that improve search ranking.\
*In YouWare:* Clean markup, metadata prompts, and fast performance boost discoverability.
* **SSL Certificate** — Encryption and identity validation for secure browsing.\
*In YouWare:* Every published project includes SSL by default—no manual setup required.
* **Publishing** — Turning a project into a live, shareable experience.\
*In YouWare:* Publish with one click and get a shareable URL instantly.
***
Missing a term? Reach out in the community forum and we’ll add it to the glossary.
# Plans & Pricing
Source: https://docs.youware.com/introduction/plans-and-pricing
Choose the perfect YouWare plan for your needs. Flexible pricing, powerful features, and complete transparency.
## Why Go Pro?
Your brand, your URL
Database & auth built-in
Rewind & get Credits back
**Unlock AI-powered creation →**
***
## How Credits Work
Credits are your creative currency on YouWare—every AI action uses Credits based on task complexity.
### What Are Credits?
YouWare Credits power all AI-driven actions on our platform:
* **AI generation** - Creating projects from prompts
* **Feature building** - Adding functionality with natural language
* **Visual changes** - UI adjustments powered by AI
**Different models, different costs:** You can choose lighter models for quick tasks or powerful models (like Claude Sonnet) for complex projects.
### What Uses Credits?
* Creating new projects from prompts
* Generating code with AI
* Building features with natural language
* Multi-file generation
* Modifying existing code with AI
* Visual editing changes
* Adding new features to projects
* Refining UI components
Different AI models cost different amounts:
* **Lighter models** (faster, cheaper) - Good for simple tasks
* **Powerful models** (Claude Sonnet 4.5) - Best for complex projects
You choose the right model for each task.
These don't use any Credits:
* Browsing projects
* Viewing code
* Publishing your site
* Manual code edits (without AI)
* Downloading code
### Credit Protection
Your Credits are protected:
* **Valid for 2 years** after purchase
* **[YouWare Credit Care](/introduction/youware-credit-care)** lets you refund failed attempts
* **Transparent usage** - see costs before you create
***
## Find Your Perfect Plan
YouWare scales with your ambition—from free exploration to unlimited creation. All plans include AI-powered creation, visual editing, and one-click publishing.
Compare plans below and choose what works for you. Cancel or change anytime—no penalties, no surprises.
[View all plans on YouWare.com →](https://www.youware.com/subscription?location=docs)
***
## Plan Comparison
Choose the plan that fits your creative needs:
**\$0 / month**
Explore what you can build
* Trial Credits only
* 1 Credit Care / month
* 5 Projects
**\$20 / month**
Build and launch real products
* 2,000 + 1,000 Credits / month
* 30 Credit Care / month
* 100 Projects
* YouBase included
* Code download & edit
**\$200 / month**
Scale and automate your business
* 20,000 + 16,000 Credits / month
* 150 Credit Care / month
* Unlimited Projects
* All Pro features
* Private Projects
* One-on-one service
### Key Features Comparison
| Feature | Free | Pro (\$20) | Ultra (\$200) |
| -------------------------------- | --------------- | ----------------- | ------------------ |
| **Credits** | Trial only | 2,000 + 1,000/mo | 20,000 + 16,000/mo |
| **Daily Credits** | Up to 300/month | Up to 1,550/month | Up to 1,550/month |
| **YouWare Credit Care** | 1 time/month | 30 times/month | 150 times/month |
| **Projects** | 5 | 100 | Unlimited |
| **YouBase** | ❌ | ✅ | ✅ |
| **Database export** | ❌ | ✅ | ✅ |
| **Database bookmark retention** | ❌ | 14 days | 14 days |
| **Database restore** | ❌ | ❌ | ✅ |
| **Storage per project** | ❌ | Unlimited\* | Unlimited\* |
| **Custom domains** | ❌ | ✅ | ✅ |
| **Credits Top-Up** | ❌ | Only yearly | Only yearly |
| **Download or edit code** | ❌ | ✅ | ✅ |
| **Hide from community** | ❌ | ✅ | ✅ |
| **Remove YouWare Badge** | ❌ | ✅ | ✅ |
| **Credit rollovers** | ❌ | ✅ | ✅ |
| **Private Projects** | ❌ | ❌ | ✅ |
| **Dedicated support** | ❌ | ❌ | One-on-one service |
| **Opt out of data training** | ❌ | ❌ | ✅ |
| **Early access to new features** | ❌ | ❌ | ✅ |
\*Storage per project is unlimited during the YouBase Beta period.
***
## Detailed Pricing
### Monthly Plans
All plans include monthly Credits with bonus Credits for paid plans. Choose monthly for flexibility.
| Plan | Price/Month | Total Credits | Credit Care | Projects | Base | Bonus |
| --------- | ----------- | ------------- | ----------- | --------- | ------ | ------ |
| **Free** | \$0 | Trial only | 1/month | 5 | - | - |
| **Pro** | \$20 | 3,000 | 30/month | 100 | 2,000 | 1,000 |
| **Ultra** | \$200 | 36,000 | 150/month | Unlimited | 20,000 | 16,000 |
### Yearly Plans
Same Credits, same features—distributed monthly. **Save 17%** with yearly billing.
Pay annually and save 17% compared to monthly billing. Same Credits, distributed monthly throughout the year.
**Pro and Ultra plans:** Unused Credits roll over month-to-month within your subscription period.
***
## Pay-as-You-Go Top-Ups
**Available for yearly plan subscribers only.** Run out of Credits? Purchase top-ups instantly when you need more.
| Top-Up Price | Total Credits | Base | Bonus | Bonus % |
| ------------ | ------------- | ------ | ------ | ------- |
| **\$20** | 2,000 | 2,000 | 0 | 0% |
| **\$100** | 13,000 | 10,000 | 3,000 | 30% |
| **\$400** | 56,000 | 40,000 | 16,000 | 40% |
**Top-up Credits are valid for two years** after purchase and can be used alongside your subscription Credits. This feature is exclusive to yearly plan subscribers.
***
## What You Get with Paid Plans
* Up to 36,000 Credits/month with bonuses
* Up to 150 Credit Care uses per month
* Daily Credits for consistent usage
* Access to all AI models
* Download complete source code
* Edit code directly in projects
* Hide projects from community
* Remove YouWare Badge
* Up to unlimited Projects
* YouBase database integration
* Database export & restore (Ultra)
* Custom domains
* Credit rollovers
* Private Projects (Ultra)
* Early access to features (Ultra)
* Opt out of data training (Ultra)
* One-on-one service (Ultra)
***
## Frequently Asked Questions
**Yes!** YouWare offers a Free plan that lets you explore what you can build.
* Trial Credits to get started
* 5 Projects included
* 1 Credit Care use per month
Upgrade to Pro or Ultra for more Credits and advanced features.
Credits are your creative currency on YouWare—every AI action uses Credits based on task complexity.
**Get more Credits by:**
* Upgrading your plan (Pro: 3,000/month, Ultra: 36,000/month)
* Purchasing Credits Top-Up (yearly plan subscribers only)
* Waiting for your monthly Credit refresh
YouWare Credit Care lets you undo AI attempts and recover all Credits used.
* **Free:** 1 time/month
* **Pro:** 30 times/month
* **Ultra:** 150 times/month
Rewind to a previous version = instant Credit refund. Perfect for trying bold ideas without risk.
[Learn more about YouWare Credit Care →](/introduction/youware-credit-care)
* **Upgrading:** Changes take effect immediately, you get the Credit difference right away
* **Downgrading:** Changes take effect at your next billing cycle
* Your existing Credits stay in your account
**Credits are valid for 2 years** after purchase.
* Top-up Credits also remain valid for 2 years
* Pro and Ultra plans include Credit rollovers
* Your Credits stay in your account even if you downgrade
**Cancel anytime** with no penalties or fees.
* You keep access to paid features until the end of your billing period
* Your Credits remain valid for 2 years
* You can reactivate anytime
Go to your account settings to manage your subscription.
You can access all your receipts and invoices from your account settings.
* Go to **Account Settings** → **Billing**
* View and download past invoices
* Update billing information
**Support options by plan:**
* **Free & Pro:** Community support and documentation
* **Ultra:** One-on-one dedicated service
Contact our support team anytime for help with your account or projects.
***
## Use Cases by Plan
### Free Plan - Perfect For:
* Learning YouWare basics
* Exploring what you can build
* Testing AI-powered creation
* Personal hobby projects (up to 5)
### Pro Plan (\$20) - Best For:
* Freelance designers and developers
* Building and launching real products
* Up to 100 projects with YouBase
* Regular AI-assisted development
### Ultra Plan (\$200) - Ideal For:
* Professional developers and agencies
* Scaling and automating your business
* Unlimited projects with private options
* Businesses requiring one-on-one service
***
**Ready to start creating?**
Visit the [official pricing page](https://www.youware.com/subscription?location=docs) to choose your plan and unlock more creative power.
Questions? Contact our support team anytime.
# Quick Start Guide
Source: https://docs.youware.com/introduction/quickstartguide
Learn how to create, customize, and publish your first web application with YouWare's AI-powered platform. No coding required - go from idea to live app in minutes.
Just 5-10 minutes to complete this guide
A YouWare account. [Sign up free](https://www.youware.com)
A modern web browser
## Get Started in 3 Steps
Create Your First Project}>
Describe your idea and let AI build it.
Edit & Refine}>
Chat with AI, use visual editing, or edit code directly.
Publish}>
Go live with one click.
## Step 1: Create Your First Project
Describe what you want to build in the Creative Command Center.
**Two Ways to Get Started: Build New or Remix Existing**
Start from scratch with your own idea, or adapt an existing project from the community.
Best for original ideas or when you want full control.
**How to Start:**
1. **Describe your idea clearly in the input box:**
**Tips for Better Results:**
* Be specific about features (e.g., "search functionality," "user login," "image upload")
* Keep descriptions concise and actionable
* Mention key requirements upfront
```text Example Prompts theme={null}
Good: "Create a recipe sharing app with search, user profiles,
and the ability to save favorites"
Too vague: "Make a cooking app"
```
2. **Press "Enter"** or click the generate button
3. **YouWare builds your project** in approximately 30 seconds
Best for rapid prototyping or learning by example.
**How to Start:**
1. Visit the community and browse public projects
2. Open any project page that fits your goal
3. Click **"Remix"** to copy it into your workspace instantly
4. Describe the changes you want
5. YouWare adapts the project to your specifications
```text Remix Examples theme={null}
"Change the color scheme to green and add a login button"
"Replace the hero image with a video background"
"Add a pricing table with three tiers"
```
**Note:** Projects created via Remix cannot be downloaded as source code. They're designed for rapid in-platform iteration and publishing.
## Step 2: Edit & Refine Your Project
Once AI builds your initial project, you have multiple tools to perfect it.
### Chat with AI
Continue the conversation with AI to make complex changes. The AI remembers your project context and can execute requests instantly.
✅ "Add a dark mode toggle to the header"
✅ "Make the 'Submit' button red and more prominent"
✅ "Connect this form to a new database table called UserFeedback"
### Visual Editing
Click any element in the preview to quickly edit text, images, colors, or layout—no coding required.
### Code Editor
For deeper customization, access your project's complete codebase directly.
View all generated files (HTML, CSS, JavaScript) and project structure. All users can inspect the code.
Make changes to any file and see results instantly in the preview. The AI can further refine your manual edits.
Everything you need is in one integrated workspace—no external tools required.
## Step 3: Publish Your Project
Your project is ready to share with the world.
### Go Live in One Click
Click the "Publish" button in the top right corner.
YouWare instantly publishes your project and gives you a shareable URL (e.g., abc.youware.app).
Share the link—it's a fully functional web application anyone can use.
### Customize Your Project
Before publishing, you can customize how your project appears:
Change the name that appears in the browser tab
Upload a custom image for the share card
**That's it!** You've built and published your first web app. Ready to build something else?
# YouWare Credit Care
Source: https://docs.youware.com/introduction/youware-credit-care
Refund Credits when AI results don't meet your needs. YouWare Credit Care protects your project budget.
## What Is YouWare Credit Care?
YouWare Credit Care lets you refund Credits when AI-generated results don't meet your needs. Each subscription plan includes monthly Credit Restore allowances.
**Key Feature:** Rewind to a previous version and restore all Credits used in that commit — instantly.
## How It Works
Build your project. Generate content, iterate on designs, or edit code with AI assistance.
Click **Rewind to previous version** on your commit history.
Select **Rewind & refund Credits**. Your remaining Credit Restore balance will be shown.
Your project reverts to the selected version. Credits are refunded instantly.
**Important:** Restoring to a previous version is permanent. You will lose all versions after the selected restore point. Credits used in those later versions are **not** refunded.
## Credit Restore Allowances
Each subscription plan includes monthly Credit Restore allowances:
| Plan | Monthly Credit Restores |
| --------- | ----------------------- |
| **Free** | 1 |
| **Pro** | 30 |
| **Ultra** | 150 |
Want more Credit Restores? [Upgrade your plan](https://www.youware.com/subscription?location=docs) for higher monthly allowances.
## Special Case: Zero-Cost Rewinds
Sometimes your commit uses **0 Credits** (like manual code edits or UI tweaks).
**In these cases, Rewind doesn't count toward your monthly Credit Restore limit.**
You can rewind freely without affecting your allowance.
Manual edits that consume 0 Credits can be rewound without using your Credit Restore allowance.
## Check Your Remaining Credit Care
1. After your conversation finishes, tap **Rewind**.
2. In the Rewind pop-up, you'll see how many uses you have left.
3. If you're out of uses, you can get more by upgrading your plan.
## FAQ
You can still use the Rewind feature to restore previous versions, but Credits won't be refunded. Your Credit Restore allowance resets monthly.
No. Credit Restore allowances reset at the start of each billing cycle and don't accumulate.
No. Each Rewind refunds Credits from one commit only. If you restore to an earlier version, Credits from multiple intermediate commits are lost permanently.
Commits using 0 Credits (manual edits) don't require Credit Restores. Rewind as many times as needed without affecting your monthly allowance.
Before confirming a Rewind, you'll see exactly how many Credits will be restored. The amount depends on what the AI generated in that commit.
***
**Upgrade for more Credit Care uses.** Pro gets 30/month, Ultra gets 150/month. Experiment boldly without wasting Credits.
[View Plans & Pricing →](https://www.youware.com/subscription?location=docs)
# Prompting 102: The Art of Conversation with AI
Source: https://docs.youware.com/prompting/prompting
Forget the jargon. If you can describe a dream, you can build a website. This is the guide for the rest of us.
Let's start with a graph that shows the journey everyone takes with AI.
You start with simple questions. Then you hear about "prompt engineering" and fall down a rabbit hole of "secret hacks" and complex formulas. You hit a wall of frustration. Finally, you arrive at a simple, profound truth: the best way to talk to an AI is just... to talk to it. Clearly and simply.
Many guides will try to turn you into a machine operator, teaching you jargon like "atomic components," "CTAs," and "user journeys." They give you a technical playbook.
This is not that guide.
This is a guide about conversation. It's for the artists, the bakers, the writers, the dreamers—anyone with an idea who has been told they need to "learn to code" to make it real. If you can describe a feeling, you can build a website.
***
## Part 1: The Big Misconception (You Are Not a Mechanic)
The biggest mistake people make when talking to an AI is thinking they need to speak its language. They believe they need to learn technical terms and complex structures to get good results.
This is completely backward.
**Your job is not to be a mechanic; your job is to be an art director.**
Imagine you're commissioning a painting. You wouldn't walk up to a brilliant artist and say, "Use a 2-inch filbert brush with a mixture of 70% cadmium yellow and 30% titanium white." The artist would be confused, and you'd get a technically precise but soulless painting.
Instead, you would say: "I want a painting of a quiet, misty morning by a lake. The feeling should be peaceful, a little lonely, but hopeful. Think of the first light of dawn."
The artist hears this and their mind explodes with possibilities. They know which brushes to use, how to mix the colors, and how to compose the scene to evoke that exact feeling.
**The AI is that brilliant, but very literal, artist. Your idea is the masterpiece. Your words are the direction.**
Forget the jargon. Forget the formulas. Your only job is to get the feeling and the story in your head out into the world through simple, human language.
***
## Part 2: The Three Golden Rules of Conversation
Instead of a long list of technical rules, let's focus on three simple principles of good conversation.
### Golden Rule #1: Start with the Feeling, Not the Features
Before you list a single thing you want on your website, describe the *vibe*. The AI is incredibly good at translating abstract feelings into concrete design choices—colors, fonts, and layouts.
How do you want people to *feel* when they arrive at your site?
| Instead of This (The Mechanic) | Try This (The Art Director) |
| :--------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| "I need a website with a header, a three-column layout, and a footer." | "I want to create a website that feels like a cozy, rainy-day bookstore. It should be warm, inviting, and a little bit nostalgic." |
| "Make a landing page for a fitness app." | "The vibe should be energetic and motivating, but not intimidating. Think bright colors, bold fonts, and a feeling of momentum, like you're just about to start a race." |
| "I need a portfolio for my photography." | "The website should feel like a quiet, minimalist art gallery. Lots of white space, elegant fonts, and nothing to distract from the photos themselves." |
When you start with the feeling, you give the AI a creative compass. It will automatically make hundreds of small, correct decisions about design because it understands the emotional goal.
### Golden Rule #2: Tell a Story, from Beginning to End
A website isn't a random collection of parts. It's a story that guides a visitor from one point to the next. Don't think in terms of "sections" or "components." Think in terms of chapters.
* **Chapter 1: The Hook.** What's the first thing your visitor sees? This is your grand opening. It should capture their attention and set the scene.
* **Chapter 2: The "Why".** Now that you have their attention, why should they care? This is where you tell them about yourself, your product, or your idea.
* **Chapter 3: The Proof.** Show, don't just tell. This could be a gallery of your work, testimonials from happy customers, or examples of what you can do.
* **Chapter 4: The Invitation.** What do you want them to do at the end of the story? This is where you invite them to contact you, buy your product, or read your blog.
**Prompting the Story:**
> "Let's build this website like a story.
>
> **First, for the beginning,** I want to welcome visitors with a huge, beautiful photo that fills the screen. Over the photo, it should say 'Handcrafted Sourdough, Baked with Love.'
>
> **Next,** I want to tell them a little about me. A short chapter with a picture of me in my kitchen and a paragraph about why I started baking.
>
> **After that,** let's show them the goods. A beautiful gallery of my best breads and pastries.
>
> **Finally, at the end of the story,** I want a simple way for them to place an order."
This narrative approach is infinitely more powerful than a dry list of features. It gives the AI context, flow, and purpose.
### Golden Rule #3: Sculpt, Don't Command
No masterpiece was ever created in a single stroke. The same is true for prompting. Your first result will never be perfect. It's not a failure; it's the first lump of clay.
Your job now is to become a sculptor. Have a conversation. Refine your creation, piece by piece.
* **Don't start over.** Build on what's there.
* **Be conversational.** Use phrases like "That's a good start, but..." or "I like that, can we try..."
* **Focus on one thing at a time.** Don't try to fix everything at once.
**The Sculpting Conversation:**
> **You:** "Okay, I see the first version. I like it, but the main title feels a bit cold and modern."
> **You:** "Can you change the font of the main title to something that looks more like handwriting? Something warm and personal."
> **You:** "Perfect! Now, the background is pure white, which feels a little stark. Can we change it to a creamy, off-white color to make it feel cozier?"
> **You:** "Yes, that's much better. The whole page feels warmer now. Thank you."
This iterative, back-and-forth dialogue is the true secret to prompt engineering. It's patient, creative, and collaborative.
***
## Part 3: Let's Try It Live - From a Feeling to a Website
Let's walk through a real example, using only the three golden rules. Our project: a website for a fictional plant shop called "The Green Nook."
#### **Prompt 1: The Feeling**
> "I want to create a website for a small, local plant shop called 'The Green Nook.' The feeling should be lush, peaceful, and organic. Imagine walking into a sun-drenched greenhouse filled with plants. The design should feel natural and earthy, not slick or corporate."
#### **Prompt 2: The Story**
> "Okay, for the story of the page:
>
> **Chapter 1 (The Welcome):** Let's start with a beautiful, full-width image of lush green leaves, with the words 'The Green Nook' in a friendly, elegant font.
>
> **Chapter 2 (Our Philosophy):** Below that, a short section with the headline 'Bring Nature Home' and a paragraph about how we believe plants make spaces happier and healthier.
>
> **Chapter 3 (Our Favorites):** Next, a simple grid showing off three of our most popular plants, each with a picture and its name.
>
> **Chapter 4 (Visit Us):** Finally, a section with our shop's address, opening hours, and a simple map."
#### **Prompt 3: The Sculpture**
> "This is a beautiful start! The overall vibe is perfect. Let's refine a few things.
>
> 1. The green you used for the text is a bit too bright. Can you change it to a deeper, more natural forest green?
> 2. In the 'Our Favorites' section, can you add a soft, subtle shadow behind each plant picture to make them 'pop' a little more?
> 3. The font for the main headlines is nice, but could we try one that's a little more rounded and soft?"
And just like that, through simple conversation, you've directed the creation of a unique, beautiful website that perfectly matches the vision in your head.
***
## Your Turn to Be the Director
You don't need a technical manual. You don't need to learn a new vocabulary. The most powerful tool you have is your own voice and your own vision.
Other guides might teach you how to operate the machine. This guide is about reminding you that **you are the artist.** The AI is just your new favorite brush.
Your ideas are the only prerequisite. Now go tell your story.
# YouWare Templates
Source: https://docs.youware.com/templates/introduction
Professionally designed, ready-to-use project starting points that help you launch faster with AI-optimized structure.
## What Are YouWare Templates?
YouWare Templates are professionally designed, ready-to-use project starting points that help you launch faster. Each template is a fully functional app or website — complete with layout, styling, content structure, and interactive components — that you can customize with AI or visual editing in minutes.
Think of templates as **solutions, not just designs**. A Yoga Studio template isn't just a pretty page — it comes with a booking flow, class schedule, instructor profiles, and testimonials section built in.
## Why Use Templates?
### Launch in Minutes, Not Hours
Skip the blank canvas. Start with a proven layout and structure, then customize it to make it yours. What used to take days now takes minutes.
### Built for Real Use Cases
Every template is designed around a specific business need:
| Category | Examples |
| ------------------- | ------------------------------------------------------------ |
| **Beauty** | Medical Aesthetics, Nail Salon, Hair Salon, Permanent Makeup |
| **Fitness** | Personal Trainer, Yoga Studio, Pilates, Gym |
| **Portfolio** | Personal Resume, Design Portfolio, Photography, Blog |
| **Build in Public** | Product Landing Page, Waiting List, Coming Soon |
| **Vertical SaaS** | Restaurant Ordering System, Internal Docs Management |
### AI-Optimized Structure
Templates are built with YouWare's AI in mind. The code is clean and well-organized, so when you chat with AI to make changes, it understands the structure perfectly and delivers better results.
### Responsive by Default
Every template looks great on desktop, tablet, and mobile — no extra work needed.
## How to Use a Template
Go to the [Template Gallery](https://www.youware.com/template) from the Creative Command Center. Browse by category or search for your use case.
Click any template to see a full live preview. Check the layout, features, and overall feel before you commit.
Found one you like? Click **"Use This Template"** to create a new project based on it. The full template is copied into your workspace — it's now yours.
Tell AI your brand name, colors, logo, images, and copy. AI understands the full template structure and updates everything in one go — headlines, buttons, footer, color scheme, all of it.
Click any element in the preview to fine-tune text, swap images, adjust colors, spacing, or rearrange sections. No code required. Perfect for pixel-level polish.
Need something the template doesn't have? Just ask AI. Add a booking system, contact form, pricing table, blog section, user authentication — anything. Enable [YouBase](/youbase/introduction) for backend features like databases, auth, and file storage.
Hit Publish to go live instantly on your `.youware.app` domain, or connect your own custom domain.
## Template Pricing
### All Templates Included with Your Subscription
Every YouWare subscription — Pro and Ultra — gives you **unlimited access to the entire template library**. No per-template fees. No hidden costs.
| What You Get | Details |
| --------------------------- | -------------------------------------------------------- |
| **All templates** | Full access to every template, every category |
| **Included Credits** | Dozens of AI customization turns included with your plan |
| **Visual & code edits** | Always free — 0 Credits |
| **Publish & custom domain** | Included with Pro and Ultra |
### How Credits Work with Templates
Your subscription comes with Credits for AI-powered customization. Typical template personalization — updating brand, content, and adding features — is comfortably covered by your plan's included Credits.
* **Pro** — Enough Credits for dozens of AI adjustments per project
* **Ultra** — Generous Credits for extensive customization and multiple projects
Visual edits and manual code changes cost **0 Credits** — always free.
### Need More?
If you need more Credits for heavy AI customization across many projects, simply upgrade to a higher plan.
[View Plans & Pricing →](https://www.youware.com/subscription)
## Frequently Asked Questions
Yes! You can use any template as many times as you want. Each use creates a separate, independent project.
Absolutely. Templates are fully editable — every line of code, every design element. You can change it so much it's unrecognizable from the original, or just tweak a few details. It's your project.
Templates provide the frontend structure. For backend features like user authentication, databases, and file storage, enable YouBase in your project settings. Some templates come with YouBase pre-configured for features like booking systems or contact forms.
Yes. We continuously add new templates based on popular use cases and community feedback. You can also submit template requests.
***
Browse the Template Gallery and launch your project in minutes.
# Database
Source: https://docs.youware.com/youbase/database
Learn how to use the YouBase Database module for structured data storage, including table management, data export, time travel, and bookmarks.
The Database module provides structured data storage for your project.
It allows you to view, manage, and export the data your project generates, and serves as the foundation for most data-driven features in YouBase.
Persistent, structured storage for your project data
Download your data anytime for backup or analysis
Restore your database to any previous state
***
## Tables Overview
The table list shows all database tables in your project.
Once data is available, the table list displays:
* All tables in the project
* The total number of rows in each table
* The latest autosave status
When the database contains data, the autosave status appears at the top: **"Autosaved: just now · Time Travel"**. Selecting **Time Travel** opens the database history and restore view.
***
## Table List Capabilities
From the table list, you can:
See all tables and their row counts
Copy table names by hovering over them
Refresh the table list to load the latest data
***
## Exporting the Database
You can export all database data at the project level.
**Export Restricted**
Clicking Export opens an upgrade prompt.
* The export feature is labeled as a Pro capability
* Upgrade to Pro or Ultra to enable database exports
**Full Export Access**
Export preparation starts immediately.
* A loading state ("Preparing data") is shown
* Once ready, the browser automatically downloads the export file
* Exports are suitable for backup and external analysis
***
## Table Details
Selecting a table opens the table detail view, where you can inspect its contents.
Navigate through records page by page
Choose 25, 50, or 100 rows per page (default: 50)
Each row represents a single record stored in the database.
***
## Working with Table Data
Inside a table, you can:
View all records stored in the table
Copy individual cell values by hovering over a cell
Copy column names for reference or debugging
Refresh the table to load the latest data
These actions allow you to inspect and verify data without modifying table structure.
***
## Exporting Table Data
You can export data from an individual table.
* Exported data is packaged as a **ZIP file**
* Each export contains only the selected table's data
Export behavior follows the same rules as database export: Free users are prompted to upgrade, while paid users receive the prepared download automatically.
***
## Table Structure & Limitations
You **cannot** manually add, edit, or delete rows
You **cannot** manually modify table structure
Tables, columns, and row data are managed by the system. Users cannot add, edit, or remove tables, columns, or rows directly. This design keeps data structures stable and avoids accidental changes in production projects.
***
## Time Travel & Bookmarks
YouBase provides a Time Travel view for database history and recovery.
This feature allows you to restore your database to a specific historical point.
Browse through all recorded database changes
Roll back to any previous state with one click
***
## Bookmarks
Bookmarks record key changes in your database and are listed in reverse chronological order (most recent first).
Each bookmark includes:
* Timestamp (displayed in the user's local timezone)
* Change description
* Affected table(s), when applicable
***
## Bookmark Types
There are three types of bookmarks:
Automatically created when the system modifies the database.
**Examples:**
* `Deleted {n} rows from "{table}"`
* `Added {n} rows to "{table}"`
* `Created table "{table}"`
* `Added column "{column}" to "{table}"`
* `Modified "{table}" with 4 changes`
* `Modified database with 2 changes`
Created manually by the user to mark an important moment.
**Example:**
* `Manual Bookmark · In Memory of 1K Users`
Use manual bookmarks to mark milestones or important states you might want to restore later.
Automatically created after a successful restore action.
**Example:**
* `Restore to 11-06 19:25:32`
These bookmarks help you track when and where you restored your database.
***
## Restore Behavior & Plan Limits
Restoring overwrites the current database state. All restore actions require confirmation.
* Can view recent bookmarks only
* Older bookmarks are hidden with an upgrade prompt
* Restore not available
* Can view bookmarks up to **14 days**
* Restore and manual bookmark actions require upgrading to Ultra
* Can restore to any available timestamp
* Can manually add bookmarks
* Full access to database recovery features
Upgrade prompts clearly indicate required plans before actions are taken.
***
## When to Use the Database
The Database module is recommended when your project needs:
Store data that persists across sessions
View and export your project's data
Recover from accidental data changes
Support for AI memory, logs, or usage history
If your project does not store structured data, the Database module is optional.
***
# Common Use Cases
Below are common scenarios where the **Database** module is useful.
You don't need to match all of them — use these examples to decide whether your project needs structured data storage.
**Scenario**
You want to store information submitted by users through a form.
**Examples**
* Contact forms
* Feedback or survey responses
* Sign-up or waitlist forms
**What the Database provides**
* Persistent storage for each submission
* Ability to review and export collected data
* A reliable record even after page refreshes or restarts
**Scenario**
Your UI displays a list of items that should update as data changes.
**Examples**
* Task or to-do lists
* Admin dashboards
* Content management views
**What the Database provides**
* Structured tables to store items
* Row-based records that map cleanly to UI elements
* Stable data that can be reused across multiple pages
**Scenario**
Each user should only see or modify their own data.
**Examples**
* Personal notes or bookmarks
* User profiles or settings
* Saved progress in a tool or workflow
**What the Database provides**
* Records that can be associated with user accounts
* Persistent data tied to a specific user identity
* A foundation for personalized experiences
*(Requires Users & Authentication)*
**Scenario**
Your AI-powered app needs to remember past interactions or inputs.
**Examples**
* Chat history
* Previous prompts or results
* Usage logs for analysis or improvement
**What the Database provides**
* Reliable storage for historical records
* Structured data suitable for querying or analysis
* A stable memory layer across sessions
**Scenario**
You are building a prototype or internal tool that relies on real data.
**Examples**
* Internal trackers
* Lightweight CRMs
* Early SaaS dashboards
**What the Database provides**
* Production-ready data storage without schema management
* Built-in export and recovery tools
* Safety features like Time Travel and bookmarks
***
## When you might not need the Database
If your project:
* Is purely static or informational
* Does not store user input or generated data
* Does not require persistence across sessions
You can keep the **Database** module disabled and enable it later when your project grows.
***
**Database is available on Pro and Ultra plans.** Store, export, and recover your project data with Time Travel and bookmarks.
[View Plans & Pricing →](https://www.youware.com/subscription?location=docs)
# YouBase Introduction
Source: https://docs.youware.com/youbase/introduction
Learn what YouBase is and how it powers your YouWare applications with cloud backend infrastructure, authentication, database, storage, and more.
Complete cloud infrastructure
Private, encrypted, and always under your control
Just describe what you need in natural language
# What is YouBase?
**YouBase is YouWare's built-in cloud backend infrastructure** — think of it as the backend that powers your application.
If YouWare's visual interface is your app's "face", then YouBase is its "brain" and "memory". Without YouBase, your app is just a pretty picture: forms can't save data, users can't log in, and nothing persists. **With YouBase enabled, your app can actually "remember" user data and display personalized content for each person.**
***
## Overview
YouBase is YouWare's cloud backend infrastructure that gives your project complete backend capabilities — including data storage, user authentication, server-side logic, and file management.
Simply describe what you need in natural language, and YouWare automatically generates the frontend and backend code, then runs it in the cloud for you. YouBase provides managed hosting, compute, and storage that scales on demand, from your first prototype to millions of users.
**YouBase runs on YouWare-managed cloud infrastructure under your project's domain** (including custom domains), so you get enterprise-grade reliability without the complexity.
***
# Why Choose YouBase
From prototype to production, YouBase scales seamlessly with your needs. Whether 10 users or 100,000 users visit your site, it loads instantly.
Private, encrypted, and always under your control. Includes enterprise-level authentication, granular access controls, and compliance best practices.
Fast and stable worldwide — no regional latency, no random downtime, no "server overload" moments.
***
# Getting Started with YouBase
**YouBase requires a [Pro or Ultra plan](https://www.youware.com/subscription?location=docs).** When your project needs backend functionality (such as user authentication or file storage), YouWare will prompt you to upgrade and enable YouBase.
## Setup for Existing Projects
For projects created **before the YouBase beta (December 16, 2025)**, enabling YouBase depends on your project type:
### Projects Without YouWare Backend MCP
* The YouBase tab displays a **"Set up YouBase"** button
* Clicking it prompts you to update your project to the latest version
* After updating, you gain access to:
* YouBase features (Database, Users, Functions, Storage)
* Independent and custom domain support
If your project uses AI API (MCP) features, those features will stop working after the update.
### Projects With YouWare Backend MCP
* These projects can **continue to work normally** with the legacy database UI
* The new Agent is **not compatible** with YouWare Backend MCP projects
* **YouBase cannot be enabled** on these projects
**Projects using the YouWare Backend MCP cannot use YouBase.** The new Agent cannot work alongside the legacy backend configuration.
You have two options:
1. **Keep using the legacy backend** - Continue with your current YouWare Backend project as it is. It will keep working indefinitely.
2. **Switch to YouBase** - If you want to use YouBase features, you need to:
* Download your project code from the legacy project
* Delete all contents in the `backend` directory from the downloaded code
* Re-upload the code to a new project and let Agent re-implement backend features using YouBase
There is no way to automatically migrate or convert a legacy backend project to YouBase.
For assistance, contact [support@youware.com](mailto:support@youware.com)
## For New Projects
Projects created **after the YouBase beta**:
* Cannot enable the YouWare Backend MCP or AI API
* Use YouBase for all backend functionality
Existing projects already using the YouWare Backend MCP or AI API can continue using those features indefinitely.
***
# Pricing & Plans
YouBase offers flexible plans to match your project's growth, from early prototypes to production applications.
## Downgrade Policy
**YouBase is immediately disabled when you downgrade from Pro/Ultra to Free.** Your data remains stored for 30 days, but database export is not available during this period. To restore access, upgrade your subscription before the 30-day retention period ends.
## Plan Comparison
| Feature | Free | Pro | Ultra |
| -------------------------------- | ---- | -------------------------------------------- | -------------------------------------------- |
| **Pricing** | \$0 | \$20/40 | \$60/100/200/500 |
| **YouBase Access** | ✗ | ✓ Includes: Auth, Secrets, Database, Storage | ✓ Includes: Auth, Secrets, Database, Storage |
| **Database Export** | ✗ | ✓ Download full DB or individual tables | ✓ Download full DB or individual tables |
| **Database Bookmark Retention** | — | 14 days | 14 days |
| **Database Restore** | — | ✗ | ✓ |
| **Database Size per Project** | — | *Unlimited during Beta* | *Unlimited during Beta* |
| **Storage per Project** | — | *Unlimited during Beta* | *Unlimited during Beta* |
| **Registered Users per Project** | — | *Unlimited during Beta* | *Unlimited during Beta* |
***
Features marked as "Unlimited during Beta" are temporarily unrestricted while YouBase is in beta. Standard limits will apply after the beta period ends.
# FAQs
No.
YouBase is modular. You can use Database, Users, Functions, or Storage independently based on your project's needs.
Yes.
Many projects use Database, Users, and Storage without writing any backend code. Functions are only required for advanced custom logic or third-party integrations.
* **Days 0–30**: YouBase is disabled, but your data is retained
* **After 30 days**: Data will be permanently deleted
Exact timing and status are displayed in the editor.
Yes.
Database data and stored files can be exported depending on your plan. See the [plan comparison](#plan-comparison) for details.
Yes.
YouBase is designed to support real users, real data, and production projects running under custom domains.
**Projects without YouWare Backend MCP:**
* A **"Set up YouBase"** button appears in the YouBase tab
* Clicking it prompts you to update your project to the latest version
* After updating, you can use YouBase features, custom domains, and independent domain names
* **Note**: Any AI API (MCP) features in your project will stop working after the update
**Projects with YouWare Backend MCP:**
* The legacy database UI is preserved
* YouBase update is not available for these projects
***
**YouBase is available on Pro and Ultra plans.** Add database, authentication, and storage to your projects today.
[View Plans & Pricing →](https://www.youware.com/subscription?location=docs)
# Secrets
Source: https://docs.youware.com/youbase/secrets
Learn how to securely store and manage sensitive values like API keys and tokens in YouBase.
Store API keys and tokens with enterprise-grade encryption
Secrets are never exposed to frontend code or users
Access secrets from Functions with simple configuration
***
## Secret Fields & Rules
Each secret includes:
A unique identifier for your secret
Timestamp when the secret was created
Secret values are **never displayed** after creation.
### Secret Name Rules
Secret names must follow these requirements:
* Maximum length: **64 characters**
* Must start with a letter
* Can only contain letters, numbers, and underscores
Invalid names are rejected with inline validation messages. For example, names starting with numbers or containing special characters will not be accepted.
***
## Secret Limits
In YouBase:
Up to **64 secrets** per project
An error prompt appears when the limit is reached
**Secret Limit Reached**
You can store up to 64 secrets. Remove unused secrets to add new ones.
***
## Managing Secrets
Navigate to the Secrets section in YouBase to see all stored secrets.
Hover over a secret to copy its name to the clipboard.
Click edit to update a secret's value. The current value is masked for security.
Click delete and confirm to permanently remove a secret.
**Deleting a secret requires confirmation.**
Are you sure you want to delete this secret?
This action cannot be undone, and anything in your project that relies on this secret may stop working. Once deleted, a secret cannot be recovered.
***
## Using Secrets
Secrets are typically accessed from **Functions**.
Secrets are only accessible from backend Functions
Secrets are never sent to the browser or visible to users
This design follows standard security practices for protecting sensitive credentials. Always use Secrets for API keys, tokens, and other sensitive values instead of hardcoding them in frontend code.
***
# Common Use Cases
Below are common scenarios where **Secrets** are required.
Use these examples to understand when sensitive values should be stored securely instead of being placed in frontend code.
**Scenario**
Your project needs to call an external service that requires an API key or token.
**Examples**
* OpenAI / Anthropic / other AI APIs
* Payment providers (e.g. Stripe)
* Email or notification services
* Analytics or monitoring tools
**Why Secrets are needed**
* API keys must not be exposed in frontend code
* Secrets keep credentials hidden from users and browsers
* Keys can be safely accessed only by server-side logic
*(Typically used together with Functions)*
**Scenario**
Your app uses AI models that require private API credentials.
**Examples**
* AI chatbots
* Content generation tools
* AI-powered data processing
**Why Secrets are needed**
* AI API keys should never be visible to users
* Secrets ensure requests are made securely from the server
* Prevents unauthorized usage or key leakage
**Scenario**
Your project integrates with external platforms that require authentication tokens.
**Examples**
* CRM systems
* Webhooks or automation tools
* Internal services or partner APIs
**Why Secrets are needed**
* Tokens and credentials are sensitive
* Storing them as Secrets avoids accidental exposure
* Credentials can be rotated without changing frontend code
**Scenario**
Your project uses different credentials for preview and production environments.
**Examples**
* Separate API keys for testing and live usage
* Different endpoints or service tokens per environment
**Why Secrets are needed**
* Keeps environment-specific values isolated
* Prevents test credentials from being used in production
* Makes it safer to iterate and debug
**Scenario**
Your project relies on values that should not be visible to end users.
**Examples**
* Private tokens
* Service credentials
* Internal identifiers or keys
**Why Secrets are needed**
* Frontend code is always visible to users
* Secrets ensure sensitive values stay on the server
* Reduces security risks by design
***
## When You Might Not Need Secrets
If your project:
* Does not call external services
* Does not require API keys or private tokens
* Runs entirely without server-side logic
You can skip **Secrets** for now and add them later as your project grows or integrates with more services.
***
**Secrets is available on Pro and Ultra plans.** Securely store API keys and tokens for your integrations.
[View Plans & Pricing →](https://www.youware.com/subscription?location=docs)
# Storage
Source: https://docs.youware.com/youbase/storage
Learn how to use the YouBase Storage module for file upload and download capabilities, including file management, multi-file downloads, and common use cases.
The storage list shows all files and folders stored in your project, organized by folders.
Store user-uploaded files in the cloud
Download files individually or as ZIP bundles
Files remain accessible across sessions and devices
***
## File & Folder List
The storage list displays items in a table view with the following columns:
File or folder name
File size (folders show `–`)
File type/extension (folders show `–`)
Timestamp in user's local timezone (folders show `–`)
Clicking a folder opens its contents. All timestamps are displayed in the user's local timezone.
***
## Downloading Files
You can download files directly from the storage list.
Choose one or more files from the storage list by clicking on them.
Click the Download button to start the download process.
For multiple files, a loading state is shown during packaging.
Downloads start automatically once preparation is complete.
Select one file and click Download.
**Behavior:**
* The file downloads directly
* No additional packaging required
Select multiple items (files or folders).
**Behavior:**
* Selected items are packaged into a ZIP file
* A loading state is shown during preparation
* Downloads start automatically once preparation is complete
For large downloads with many files, the preparation step may take a few moments. The download will begin automatically once the ZIP is ready.
***
## Refreshing Storage
Find the refresh icon at the top of the storage list.
Click the refresh icon to reload the file list.
The storage list updates to show the most recent files and folders.
Use refresh to see newly uploaded files or verify storage changes made by your application.
***
## Storage Limitations
In YouBase, certain features are intentionally limited:
File upload and download are **supported**
File preview is **not supported**
File deletion is **not supported**
Agents **cannot** directly modify storage contents
These limitations are intentional to reduce risk and complexity in early versions.
***
## When to Use Storage
Storage is recommended when your project needs:
User-uploaded files (images, documents, attachments)
Generated assets or exports
Media or documents associated with records
Bundled downloads for offline work
If your project does not handle files, Storage can be ignored and enabled later when needed.
***
# Common Use Cases
Below are common scenarios where **Storage** is useful.
Use these examples to decide whether your project needs file upload and download capabilities.
**Scenario**
Users need to upload files as part of your product experience.
**Examples**
* Profile photos / avatars
* Resume or document uploads
* Attachments submitted with forms
**What Storage provides**
* A safe place to store uploaded files
* Download access when you need to retrieve files later
* A reliable file layer for real user workflows
**Scenario**
Your project generates files that users should be able to download.
**Examples**
* AI-generated reports (PDFs)
* Exported summaries or results
* Generated images or documents
**What Storage provides**
* A place to store generated assets
* Simple download flows (single file or ZIP)
* A stable way to deliver outputs to users
*(Often used together with Functions)*
**Scenario**
Each item in your database should have related files.
**Examples**
* A product catalog where each product has images
* A content library with attachments
* A CRM where each customer record stores documents
**What Storage provides**
* File storage that can be associated with database records
* A simple way to manage assets across your app
*(Often used together with Database)*
**Scenario**
Users need to download multiple files at once.
**Examples**
* Downloading a set of generated assets
* Exporting a collection of attachments for review
* Collecting files for offline work
**What Storage provides**
* Download multiple files or folders as a ZIP archive
* Automatic preparation and download once ready
**Scenario**
Files should remain accessible after refresh, logout, or on another device.
**Examples**
* A workspace where users revisit uploaded documents later
* A tool that stores ongoing project assets
* Returning users downloading previously generated outputs
**What Storage provides**
* Persistent, cloud-hosted file storage
* Consistent access across sessions and environments
***
## When you might not need Storage
You may not need Storage if your project:
* Doesn't accept uploads
* Doesn't generate downloadable files
* Doesn't attach media/documents to stored records
Storage can be enabled later when your project expands into file-based workflows.
***
**Storage is available on Pro and Ultra plans.** Upload, download, and manage files for your projects.
[View Plans & Pricing →](https://www.youware.com/subscription?location=docs)
# Users & Authentication
Source: https://docs.youware.com/youbase/users-authentication
Quickly integrate login functionality into your project with built-in user management and centralized authentication.
## Core Capabilities
Add Email and Google login to your YouWare project with minimal setup
Maintain a centralized user list with essential management features in YouBase
Monitor user activity and usage patterns through a dedicated dashboard
***
## Authentication Methods
Built-in email authentication with secure password handling
One-click Google OAuth integration
Allow users to access your app without registration
### Authentication Settings
Configure which login methods your project supports and whether to allow new user registrations.
Traditional email and password authentication.
**Features:**
* Sign in with email and password
* Optional email verification
* Forgot password flow
Authentication flows, password handling, and credential storage are fully managed by YouBase.
One-click login with Google accounts.
**Features:**
* Quick sign-in via Google account
* No password management required
* Trusted identity provider
Users can sign in instantly with their existing Google account.
Let users access your app without registration.
**Features:**
* Anonymous login support for frictionless access
* Automatic user record creation for temporary sessions
* Temporary users included in analytics
Ideal for reducing barriers to entry and improving conversion.
Sensitive authentication data (such as passwords or tokens) is never exposed to the frontend.
***
## User Management
The User Management module consists of two main components:
* **User List**: View user details and perform management actions
* **Dashboard**: Monitor total users (registered and temporary), daily activity, and trends
### Dashboard
The Dashboard provides visual insights into your user base:
View total counts for registered users and temporary accounts
Track daily activity and growth patterns over time
### User List
The User List displays all registered users in your project.
**No users yet.**
Users will appear here once someone signs up or logs in.
Each user row displays the following information:
System-generated unique identifier
User's registered email
Email, Google, or Temporary
Active or Blocked
Account creation timestamp
All timestamps are displayed in the user's local timezone. User IDs are immutable and used internally to associate data with users.
### User Operations
User management supports four actions:
Manually create a new user account
Remove a user account (the user can re-register afterwards; useful for removing test data)
Suspend user access (blocked users cannot log in or re-register)
Restore access for a previously blocked user
**Delete vs Block**: Deleted users can re-register with the same email. Blocked users cannot log in or re-register until unblocked.
***
## Email Security
Configure email-related security options for your project.
**Email Verification**: Require users to verify their email address before logging in. Enable this option to ensure users provide valid email addresses.
Require users to verify their email before accessing the app
Require email verification code when resetting passwords
Automatically sign out all sessions when a user changes their password
***
## Custom UI
The login component uses a platform-provided default style.
To customize the login UI, send prompts to Agent, which modifies and re-renders the UI based on your instructions.
**Example prompt:**
Update the default login UI to match our current website style.
If you later update your Auth configuration, send another prompt to Agent to re-render the login UI based on the latest Auth configuration.
**Example prompt:**
Re-render the login UI based on the latest Auth configuration.
***
## Common Use Cases
Below are some common scenarios where **Users & Authentication** is useful.
You don't need to implement all of these — use them as references to decide whether this module fits your project.
**Scenario**
You want some pages or features to be accessible only after login.
**Examples**
* A private dashboard
* A paid or invite-only tool
* Internal tools for a team
**What Users & Auth provides**
* User login and identity
* Ability to block or allow access per user
**Scenario**
Different users should see or modify their own data.
**Examples**
* A form where each user sees their own submissions
* A to-do list or notes app
* An AI tool that remembers past inputs per user
**What Users & Auth provides**
* A stable user ID
* The ability to associate database records with specific users
**Scenario**
Your app should behave differently depending on who is using it.
**Examples**
* Showing "Welcome back" messages
* Displaying user-specific settings or preferences
* Restoring previous sessions or history
**What Users & Auth provides**
* User identity recognition
* Persistent accounts across sessions and devices
**Scenario**
You want to temporarily disable a user without losing their data.
**Examples**
* Suspending a user account
* Restricting access during testing
* Handling misuse or abuse cases
**What Users & Auth provides**
* Block / unblock user access
* Preservation of all existing user data
**Scenario**
You are building an MVP or prototype and want basic login without managing auth logic.
**Examples**
* Early SaaS prototypes
* Side projects with limited users
* Internal demos
**What Users & Auth provides**
* Fully managed email or Google login
* Secure password handling without backend setup
***
## When you might not need Users & Auth
If your project:
* Does not require login
* Does not store user-specific data
* Is purely informational or static
You can keep **Users & Auth** disabled and enable it later when needed.
***
**Users & Authentication is available on Pro and Ultra plans.** Add login, user management, and analytics to your projects today.
[View Plans & Pricing →](https://www.youware.com/subscription?location=docs)