This template supports two distinct development workflows:

When to use: Starting a new project where the backend doesn't exist yet. You'll develop the frontend with a temporary Supabase backend, then generate an OpenAPI specification for the backend team to implement.

Get started:

http://bolt.new/github.com/poviolabs/bolt-template

📖 Read the full Mode 1 documentation

When to use: Backend is already developed or being developed in parallel and is deployed with an accessible OpenAPI specification endpoint.

Get started:

http://bolt.new/github.com/poviolabs/bolt-template/tree/external-be

📖 Read the full Mode 2 documentation

Essential reading: Best practices for prompting Bolt effectively, choosing AI models, using planning mode, and implementing designs.

📖 Read the Prompting Guide

• UI Components: @povio/ui with lucide-react icons
• Data Fetching: @tanstack/react-query for server state management
• Forms: react-hook-form for form management using our wrapper hooks from @povio/ui
• Routing: @tanstack/react-router with file-based routing
• Global State: zustand for client-side state
• Styling: tailwindcss with custom configuration
• Validation: zod for schema validation

The src/pages/code-examples/ directory contains usage examples of @povio/ui and major patterns for the AI to check.

⚠️ These files should NEVER be modified by the AI agent - they are reference only and can be removed once Bolt development is finished.

• Bolt Documentation: docs/ directory
• Rules Documentation for Bolt: rules/ directory
• Component Examples: src/pages/code-examples/

For issues or suggestions:

• Check the mode-specific documentation in docs/
• Contact "Tadej Rebernjak" on Slack