Creating a Project
Create a new project in Hyper to start building your application.
Click New Project in the top-right corner, or + Create Project in the left sidebar.
Project creation flow
When you click New Project, you go through these steps:
| Step | Description |
|---|---|
| 1. Name Your Project | Enter a name for your project |
| 2. Select Industry | Choose your industry domain or enter a custom one |
| 3. Upload Logo | Optional project logo (max 500KB) |
| 4. Select Color Theme | Choose a color theme for Studio |
| 5. Choose Start Method | Select how you want to build your app |
| 6. Generate/Import | Build with AI, import a schema, or start from scratch |
| 7. Review & Create | Review generated schema and create |
Starting methods
Choose how you want to create your project:
- Build an app with AI — Let AI help you create your app based on your description.
- Import a schema — Start with an existing database schema or API.
- Start from scratch — Build your app step by step with complete control.
Project Name
Enter a descriptive name for your project. This helps identify your app in the platform and is used for project metadata.
Example names:
- Sales Automation App
- Inventory Management System
- Healthcare Portal
Industry
Choose the industry that best matches your application. This helps Hyper tailor recommendations and structure to your business domain.
Available industries include:
- Aviation
- Healthcare
- Retail
- Logistics
- HRM / ERP
- Other — Enter a custom industry
Selecting an industry activates domain-specific context, so your generated schema includes expected workflows, entities, and compliance requirements.
Logo
Upload a project logo to personalize your workspace.
| Constraint | Requirement |
|---|---|
| Max Size | 500KB |
| File Types | Image files (PNG, JPG, SVG) |
Color theme
Choose a color theme for your Studio workspace.
The color theme applies to the Studio workspace, not to the generated application. Set your generated app's theme in Settings → Theme.
Start method
Select how you want to build your application:
Build an app with AI
Let AI help you create your app based on your description. This is the recommended approach for:
- Quick prototyping
- Pre-sales demos
- Projects where you know the requirements but not the exact schema
Learn more about AI-assisted building →
Import a schema
Start with an existing database schema or API. Best for:
- Migrating existing applications to Hyper
- Starting from an established data model
- Teams with existing database designs
Learn more about schema import →
Start from scratch
Build your app step by step with complete control. Ideal for:
- Experienced users who know exactly what they want
- Projects requiring precise manual configuration
- Learning how Hyper works in detail
Build an app with AI
When you select Build an app with AI, you use the Requirement Agent to generate your application schema.
Providing requirements
You can provide requirements in two ways:
| Method | Description |
|---|---|
| Prompt | Describe your app in the text area |
| Upload Document | Upload a PRD or specification document (PDF, DOCX) |
Example prompt:
Build a procurement management system for multiple departments
with approvals, supplier onboarding, and audit logs.
Select model
Choose the AI model for generation. The default is set by your organization.
Review generated schema
After clicking Next, the AI generates:
- Summary — A text description of what was generated
- Collections — List of tables/entities with their fields
- Relations — ERD diagram showing table relationships
- Access Control — Suggested roles and permissions
You can:
- Click + Modify Schema to adjust the generated structure
- Switch between Relations, Collections, and Access Control tabs
- Click Create this app when satisfied
See Requirement Agent for detailed documentation.
Import a schema
Upload a SQL file and Hyper reads your database schema and generates all collections, fields, and relationships automatically — no manual setup required.
Supported formats
| Format | Extension |
|---|---|
| MySQL | .sql |
| PostgreSQL | .sql |
| SQL Server | .sql, .bak |
| DBML | .dbml |
Upload your schema
Drag and drop your file onto the upload area, or click to browse. Then click Process SQL to analyze the schema.
Import options
Schema options
| Option | Description |
|---|---|
| Keep original field names and types | Preserves the original database naming and field types exactly |
Table options
| Option | Description |
|---|---|
| Keep existing tables | Adds imported tables alongside any existing tables |
| Delete all existing tables | Clears all tables before import |
| Replace existing tables | Replaces tables that share a name with imported ones |
Additional options
| Option | Description |
|---|---|
| Auto-generate primary key | Adds a primary key to any table that doesn't have one |
| Auto-generate reverse relations | Creates inverse relationship fields automatically |
| Ignore fields | Skips specific fields during import |
After Hyper processes the file, review the generated schema in the Review and create step.
Start from scratch
When you select Start from scratch, you skip the AI generation step and go directly to an empty project. You manually create:
- Collections — Define your data tables
- Fields — Add fields to each collection
- Relationships — Connect collections together
- Roles — Set up access control
- Areas — Set up your application screens
This approach gives you complete control from the beginning.
Review and create
Before creating your project, review the generated or imported schema:
Schema review tabs
| Tab | Description |
|---|---|
| Relations | Interactive ERD diagram showing table relationships |
| Collections | List of all tables with field details |
| Access Control | Suggested roles and permissions |
Collections view
Click any collection in the sidebar to see its fields with:
- Field name and type
- Properties — Primary key, Unique, Indexed, Required badges
Modifying the schema
Click + Modify Schema to make changes before creating:
- Add or remove collections
- Edit field properties
- Adjust relationships
Creating the project
When satisfied with the schema, click Create this app to:
- Create the project
- Generate all collections and fields
- Set up relationships
- Set up initial roles
- Open the project in Studio
Related
- Requirement Agent — Detailed AI generation documentation
- Studio overview — Working inside your project after creation
- Collections — Working with collections
- Fields — Available field types