Frequently Asked Questions
Answers about AI generation, DBML, projects, GitHub, and deployments.
General
QuickCode is a diagram-driven microservices generator. You describe your system in plain language or DBML, and QuickCode produces production-ready .NET services with API endpoints, Dapper data access, and optional QuickCode DSL for custom Query, Update, and Delete operations—plus GitHub repositories and CI/CD pipelines aimed at Google Cloud Run.
Start on the homepage with Try generating with AI or open an existing project in QuickCode Studio. QuickCode turns your description into modules and DBML, you refine the schema, then choose database type and architecture (CQRS + Mediator or Service). Generation pushes code to GitHub; each project can include GitHub Actions workflows for build and deploy.
Yes. Describe your microservice system in natural language on the homepage; QuickCode proposes modules and initial DBML. You can edit the result in Studio before generating. Many teams use AI for a first draft, then refine tables, relationships, and DSL notes by hand.
QuickCode is currently offered free of charge, as is. We may introduce paid plans or premium features later; any change will be announced in advance.
There is no separate sign-up flow. When you set up a project you provide a project name and work email. A one-time secret code is emailed to you; you need it to open the project in Studio and run generation. That combination identifies and protects your workspace.
Services are generated in C# / .NET with Dapper for database access, following modern layering (API, application, persistence). Default CRUD is generated from your tables; custom Query, Update, and Delete endpoints are added with QuickCode DSL in DBML Note blocks.
Technical
DBML (Database Markup Language) is a readable way to define tables, columns, enums, and relationships. QuickCode includes a DBML editor in Studio. For syntax, column types, relationships, and DSL rules, see the Documentation.
QuickCode DSL is a one-line, intent-based notation inside DBML Note sections. It describes custom queries, updates, and deletes—filters, joins, pagination, and similar—not general programming logic. Standard CRUD endpoints are generated automatically; add DSL only for operations beyond that. Full reference: DBML & DSL guide.
When you create or configure a project you can target PostgreSQL, MySQL, or SQL Server. Generated SQL, connection strings, and migrations are tailored to the type you select.
The QuickCode CLI runs from your terminal: check or create projects, sync DBML, trigger generation, and pull repositories. Use it for automation, local workflows, or when you prefer not to use the browser. Install via Homebrew (macOS), Scoop (Windows), or a GitHub release—see the CLI Tool page.
Each project gets a GitHub repository under the QuickCodeNet organization, typically at https://github.com/QuickCodeNet/your-project-name. Clone, fork, or download as ZIP from GitHub. Pipelines in the repo can build and deploy services (for example to Google Cloud Run).
Generated projects include GitHub Actions workflows that build container images and deploy to Google Cloud Run, with separate pipelines per service where applicable. You connect your cloud credentials and settings in your own GitHub/environment setup; QuickCode supplies the generated workflow structure as a starting point.
Projects & security
- Describe your system on the homepage (Try generating with AI) or prepare DBML in Studio.
- Complete Set Up Your Project: project name and work email.
- Confirm access with the secret code sent to your email.
- Refine modules, DBML, database type, and architecture (CQRS or Service).
- Run generation and use the GitHub repository (and optional Cloud Run pipelines).
Step-by-step detail: Quick start.
Open QuickCode Studio with your project name, email, and secret code. Update DBML or DSL, then regenerate; changes are pushed to your GitHub repository. You can also use the CLI to pull DBML, edit locally, and upload with update-dbmls.
The secret code is a 20-character key emailed to your work address. It proves you control the inbox tied to the project. You need it to continue after setup and to return to the project later. Do not share it. If you lose it, use Forgot secret code? in the setup flow or Studio to request a new code.
Access to a project requires the correct project name, email, and secret code. DBML and project metadata are stored on QuickCode infrastructure; treat DBML as design data, not a place for live secrets or PII you would not put in source control. Review generated repos and cloud credentials in your own environment. See our Privacy Policy for more.
Troubleshooting
Parse errors usually mean invalid DBML syntax. Common causes:
- Missing or mismatched quotes on table/column names
- Incorrect
Ref:relationship syntax - Invalid or unsupported column types
- Malformed DSL inside
Noteblocks (see docs for Query/Update/Delete rules)
Use Studio’s editor and compare with examples in Documentation.
- Invalid DBML or DSL syntax
- Project name already taken or invalid format
- Wrong or expired secret code, or email that does not match the project
- GitHub repository name conflict
- Temporary service or network issues
Fix validation messages, verify your secret code, and try again. Persistent failures: Contact us.
- Update to the latest CLI release
- Confirm network access to QuickCode APIs
- Verify project name, email, and
secret_codein config - Reinstall via Homebrew, Scoop, or the GitHub release binary
Command reference: CLI Tool · Contact support
More detail in Documentation · Contact support