Getting started: account, organisation, trial, first project

Welcome to Tekspaz! This guide will take you from creating your account to launching your very first project in under five minutes.

Tekspaz brings software planning, code generation, autonomous infrastructure operations, and cloud data warehouse cost optimization into a single unified platform. Everything is governed by human-in-the-loop authorization gates—nothing reaches your live codebase or production cloud without your explicit sign-off.

---

1. Creating your account

You can register for Tekspaz on the public site at tekspaz.ai/register.

1. Navigate to tekspaz.ai/register.
2. Choose your sign-in method:
   • Work Email & Password: Enter your corporate email address (e.g., you@yourcompany.com) and choose a strong password.
   • GitHub OAuth: Click Continue with GitHub to link your existing GitHub identity. This automatically simplifies connecting your GitHub repositories later.
   • Google OAuth: Click Continue with Google for single sign-on with your Google Workspace identity.
3. If signing up with email and password, check your inbox for the verification link and click it to confirm your email.

[!NOTE] To share workspaces with your team, use your company email domain. Tekspaz automatically groups teammates using the same email domain into your company organisation.

---

2. Setting up your organisation

Every workspace in Tekspaz belongs to an Organisation. An organisation isolates projects, data sources, API keys, and team members.

Personal vs. Company workspaces

• Personal Workspace: Automatically provisioned if you sign in with a personal email address (e.g. @gmail.com or @outlook.com). Suitable for individual exploration, prototypes, and side projects.
• Company Organisation: Provisioned when signing in with a corporate domain (e.g. @acme.com). Allows multiple members, role-based access, and shared team billing.

Member roles & permissions

Organisation access is managed under Organization › Members (/organization):

Role	Permissions
Owner	Full administrative rights, billing management, organisation deletion, member role assignment.
Admin	Approves project access requests, manages integrations (GitHub, Vercel, Snowflake), invites members.
Member	Creates and interacts with projects, answers planning questionnaires, approves sandbox previews.

Inviting teammates

1. Go to the platform sidebar and select Organization.
2. Click Invite Member.
3. Enter their email address and select their role (Member or Admin).
4. They will receive an invitation link to join the organisation immediately.

---

3. Understanding your trial and AI credits

Every new organisation receives an Individual Trial allocation upon signup:

• Monthly Free Credits: 300 AI credits renewed every month.
• Included Capabilities:
  • Unlimited problem statement planning in TeksPlan.
  • Plan Bundle generation (OpenAPI contracts, data schemas, architecture diagrams, and task breakdowns).
  • Cloud Runbox sandbox preview builds in TeksBuild.
  • Standard email and community support.
• Early Access Tier: While Tekspaz is in Early Access, connected cloud runs (GitHub, Vercel, Snowflake, and Databricks) carry zero platform subscription fees.

How credits are consumed

AI credits cover LLM inference across specialized planning agents, coding loops, and diagnostic workers:

• Planning Run: ~20–30 credits for a complete 7-agent debate and Plan Bundle.
• Build & Test Loop: ~10–15 credits per code generation and diagnostic self-heal cycle.
• FinOps Analysis: Native queries run inside your Snowflake/Databricks compute and do not consume platform AI credits.

You can monitor credit burn in real time from Settings › Usage & Billing.

---

4. Launching your first project

With your account and organisation ready, you can create your first project in four steps:

Step 1: Open New Project

From the platform sidebar, click Workspace or Projects, then click the + New Project button (or navigate to /projects/new).

Step 2: Choose project archetype

Select the archetype that best matches what you want to build:

1. Application Project (Default): Full-stack web application, API backend, microservice, or mobile backend.
2. Data Platform Project: Data warehouse models, dbt pipelines, Snowflake/Databricks transformations, and Lakehouse orchestration.

Step 3: Enter your problem statement

Describe what you want to build in plain English. You do not need to write technical specifications—just express the business need:

Build an internal dashboard for customer support leads to monitor ticket resolution times, 
escalate tickets breached beyond 2 hours, and export weekly summary reports to CSV.

Step 4: Configure initial tech stack (optional)

By default, Tekspaz selects the best tested stack for your archetype (e.g., Astro + React + Tailwind + PostgreSQL for web apps). You can also explicitly choose:

• Frontend: React, Vue, Svelte, or Next.js
• Backend: Node.js (TypeScript) or Python (FastAPI)
• Database: PostgreSQL, SQLite, or Snowflake
• Deployment Target: Vercel, AWS ECS, or Docker Runbox

Click Start Planning. TeksPlan’s 7-agent panel will instantly begin interrogating the requirement and structuring your project!

---

What to explore next

• TeksPlan: writing a good request and approving plans
• TeksBuild: sandbox preview, code review, and deployments
• Connect GitHub and Vercel