feat(turbo): restructured repo to be a standard turborepo monorepo (#341)

* added turborepo

* finished turbo migration

* updated gitignore

* use dotenv & run format

* fixed error in docs

* remove standalone deployment in prod

* fix ts error, remove ignore ts errors during build

* added formatter to the end of the docs generator

Author: waleedlatif1

.devcontainer/.bashrc

@@ -18,14 +18,20 @@ alias pgc="PGPASSWORD=postgres psql -h db -U postgres -d simstudio"
 alias check-db="PGPASSWORD=postgres psql -h db -U postgres -c '\l'"
 
 # Sim Studio specific aliases
-alias logs="cd /workspace/sim && tail -f logs/*.log 2>/dev/null || echo 'No log files found'"
-alias sim-start="cd /workspace/sim && npm run dev"
-alias sim-migrate="cd /workspace/sim && npx drizzle-kit push"
-alias sim-generate="cd /workspace/sim && npx drizzle-kit generate"
-alias sim-rebuild="cd /workspace/sim && npm run build && npm start"
+alias logs="cd /workspace/apps/sim && tail -f logs/*.log 2>/dev/null || echo 'No log files found'"
+alias sim-start="cd /workspace && npm run dev"
+alias sim-migrate="cd /workspace/apps/sim && npx drizzle-kit push"
+alias sim-generate="cd /workspace/apps/sim && npx drizzle-kit generate"
+alias sim-rebuild="cd /workspace && npm run build && npm run dev"
+alias docs-dev="cd /workspace/apps/docs && npm run dev"
 
-# Default to sim directory
-cd /workspace/sim 2>/dev/null || true
+# Turbo related commands
+alias turbo-build="cd /workspace && npx turbo run build"
+alias turbo-dev="cd /workspace && npx turbo run dev"
+alias turbo-test="cd /workspace && npx turbo run test"
+
+# Default to workspace directory
+cd /workspace 2>/dev/null || true
 
 # Welcome message - only show once per session
 if [ -z "$SIM_WELCOME_SHOWN" ]; then
@@ -36,10 +42,16 @@ if [ -z "$SIM_WELCOME_SHOWN" ]; then
   echo "🚀 Welcome to Sim Studio development environment!"
   echo ""
   echo "Available commands:"
-  echo "  sim-start    - Start the development server"
-  echo "  sim-migrate  - Push schema changes to the database"
-  echo "  sim-generate - Generate new migrations"
-  echo "  sim-rebuild  - Build and start the production server"
+  echo "  sim-start    - Start all apps in development mode"
+  echo "  sim-migrate  - Push schema changes to the database for sim app"
+  echo "  sim-generate - Generate new migrations for sim app"
+  echo "  sim-rebuild  - Build and start all apps"
+  echo "  docs-dev     - Start only the docs app in development mode"
+  echo ""
+  echo "Turbo commands:"
+  echo "  turbo-build  - Build all apps using Turborepo"
+  echo "  turbo-dev    - Start development mode for all apps"
+  echo "  turbo-test   - Run tests for all packages"
   echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
   echo ""
 fi 

.devcontainer/Dockerfile

@@ -23,12 +23,13 @@ RUN echo "$USERNAME ALL=(ALL) NOPASSWD: ALL" > /etc/sudoers.d/$USERNAME \
 RUN npm install -g npm@latest
 
 # Install global packages
-RUN npm install -g drizzle-kit
+RUN npm install -g drizzle-kit turbo
 
 # Switch back to dialog for any ad-hoc use of apt-get
 ENV DEBIAN_FRONTEND=dialog
 
 WORKDIR /workspace
 
 # Expose the ports we're interested in
-EXPOSE 3000
+EXPOSE 3000
+EXPOSE 3001

.devcontainer/docker-compose.yml

@@ -18,8 +18,9 @@ services:
       db:
         condition: service_healthy
     ports:
-      - "3000:3000"
-    working_dir: /workspace/sim
+      - '3000:3000'
+      - '3001:3001'
+    working_dir: /workspace
 
   db:
     image: postgres:16
@@ -31,12 +32,12 @@ services:
       - POSTGRES_PASSWORD=postgres
       - POSTGRES_DB=simstudio
     ports:
-      - "5432:5432"
+      - '5432:5432'
     healthcheck:
-      test: ["CMD-SHELL", "pg_isready -U postgres"]
+      test: ['CMD-SHELL', 'pg_isready -U postgres']
       interval: 5s
       timeout: 5s
       retries: 5
 
 volumes:
-  postgres-data: 
+  postgres-data:

.devcontainer/post-create.sh

@@ -5,8 +5,8 @@ set -e
 
 echo "🔧 Setting up Sim Studio development environment..."
 
-# Change to the sim directory
-cd /workspace/sim
+# Change to the workspace root directory
+cd /workspace
 
 # Setup .bashrc
 echo "📄 Setting up .bashrc with aliases..."
@@ -19,23 +19,31 @@ echo "📦 Cleaning and reinstalling npm dependencies..."
 if [ -d "node_modules" ]; then
   echo "Removing existing node_modules to ensure platform compatibility..."
   rm -rf node_modules
+  rm -rf apps/sim/node_modules
+  rm -rf apps/docs/node_modules
 fi
 
 # Install dependencies with platform-specific binaries
 npm install || {
   echo "⚠️ npm install had issues but continuing setup..."
 }
 
-# Set up environment variables if .env doesn't exist
-if [ ! -f ".env" ]; then
+# Set up environment variables if .env doesn't exist for the sim app
+if [ ! -f "apps/sim/.env" ]; then
   echo "📄 Creating .env file from template..."
-  cp .env.example .env 2>/dev/null || echo "DATABASE_URL=postgresql://postgres:postgres@db:5432/simstudio" > .env
+  if [ -f "apps/sim/.env.example" ]; then
+    cp apps/sim/.env.example apps/sim/.env
+  else
+    echo "DATABASE_URL=postgresql://postgres:postgres@db:5432/simstudio" > apps/sim/.env
+  fi
 fi
 
 # Generate schema and run database migrations
 echo "🗃️ Running database schema generation and migrations..."
 echo "Generating schema..."
+cd apps/sim
 npx drizzle-kit generate
+cd ../..
 
 echo "Waiting for database to be ready..."
 # Try to connect to the database, but don't fail the script if it doesn't work
@@ -44,7 +52,9 @@ echo "Waiting for database to be ready..."
   while [ $timeout -gt 0 ]; do
     if PGPASSWORD=postgres psql -h db -U postgres -c '\q' 2>/dev/null; then
       echo "Database is ready!"
+      cd apps/sim
       DATABASE_URL=postgresql://postgres:postgres@db:5432/simstudio npx drizzle-kit push
+      cd ../..
       break
     fi
     echo "Database is unavailable - sleeping (${timeout}s remaining)"
@@ -61,13 +71,13 @@ echo "Waiting for database to be ready..."
 cat << EOF >> ~/.bashrc
 
 # Additional Sim Studio Development Aliases
-alias migrate="cd /workspace/sim && DATABASE_URL=postgresql://postgres:postgres@db:5432/simstudio npx drizzle-kit push"
-alias generate="cd /workspace/sim && npx drizzle-kit generate"
-alias dev="cd /workspace/sim && npm run dev"
-alias build="cd /workspace/sim && npm run build"
-alias start="cd /workspace/sim && npm run start"
-alias lint="cd /workspace/sim && npm run lint"
-alias test="cd /workspace/sim && npm run test"
+alias migrate="cd /workspace/apps/sim && DATABASE_URL=postgresql://postgres:postgres@db:5432/simstudio npx drizzle-kit push"
+alias generate="cd /workspace/apps/sim && npx drizzle-kit generate"
+alias dev="cd /workspace && npm run dev"
+alias build="cd /workspace && npm run build"
+alias start="cd /workspace && npm run dev"
+alias lint="cd /workspace/apps/sim && npm run lint"
+alias test="cd /workspace && npm run test"
 EOF
 
 # Source the .bashrc to make aliases available immediately

sim/.env.example .env.examplesim/.env.example renamed to .env.example

@@ -14,22 +14,22 @@ appearance, race, religion, or sexual identity and orientation.
 Examples of behaviour that contributes to a positive environment for our
 community include:
 
-* Demonstrating empathy and kindness toward other people
-* Being respectful of differing opinions, viewpoints, and experiences
-* Giving and gracefully accepting constructive feedback
-* Accepting responsibility and apologising to those affected by our mistakes,
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologising to those affected by our mistakes,
   and learning from the experience
-* Focusing on what is best not just for us as individuals, but for the
+- Focusing on what is best not just for us as individuals, but for the
   overall community
 
 Examples of unacceptable behaviour include:
 
-* The use of sexualised language or imagery, and sexual attention or advances
-* Trolling, insulting or derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or email
+- The use of sexualised language or imagery, and sexual attention or advances
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or email
   address, without their explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
+- Other conduct which could reasonably be considered inappropriate in a
   professional setting
 
 ## Our Responsibilities
@@ -112,4 +112,4 @@ the community.
 This Code of Conduct is adapted from the [Contributor Covenant](https://contributor-covenant.org/), version
 [1.4](https://www.contributor-covenant.org/version/1/4/code-of-conduct/code_of_conduct.md) and
 [2.0](https://www.contributor-covenant.org/version/2/0/code_of_conduct/code_of_conduct.md),
-and was generated by [contributing.md](https://contributing.md/generator).
+and was generated by [contributing.md](https://contributing.md/generator).

.github/CODE_OF_CONDUCT.md

@@ -3,7 +3,7 @@
 Thank you for your interest in contributing to Sim Studio! Our goal is to provide developers with a powerful, user-friendly platform for building, testing, and optimizing agentic workflows. We welcome contributions in all forms—from bug fixes and design improvements to brand-new features.
 
 > **Project Overview:**  
-> Sim Studio is a monorepo containing the main application (`sim/`) and documentation (`docs/`). The main application is built with Next.js (app router), ReactFlow, Zustand, Shadcn, and Tailwind CSS. Please ensure your contributions follow our best practices for clarity, maintainability, and consistency.
+> Sim Studio is a monorepo using Turborepo, containing the main application (`apps/sim/`), documentation (`apps/docs/`), and shared packages (`packages/`). The main application is built with Next.js (app router), ReactFlow, Zustand, Shadcn, and Tailwind CSS. Please ensure your contributions follow our best practices for clarity, maintainability, and consistency.
 
 ---
 
@@ -269,26 +269,26 @@ Sim Studio is built in a modular fashion where blocks and tools extend the platf
 
 ### Where to Add Your Code
 
-- **Blocks:** Create your new block file under the `/sim/blocks/blocks` directory. The name of the file should match the provider name (e.g., `pinecone.ts`).
-- **Tools:** Create a new directory under `/sim/tools` with the same name as the provider (e.g., `/sim/tools/pinecone`).
+- **Blocks:** Create your new block file under the `/apps/sim/blocks/blocks` directory. The name of the file should match the provider name (e.g., `pinecone.ts`).
+- **Tools:** Create a new directory under `/apps/sim/tools` with the same name as the provider (e.g., `/apps/sim/tools/pinecone`).
 
 In addition, you will need to update the registries:
 
-- **Block Registry:** Update the blocks index (`/sim/blocks/index.ts`) to include your new block.
-- **Tool Registry:** Update the tools registry (`/sim/tools/index.ts`) to add your new tool.
+- **Block Registry:** Update the blocks index (`/apps/sim/blocks/index.ts`) to include your new block.
+- **Tool Registry:** Update the tools registry (`/apps/sim/tools/index.ts`) to add your new tool.
 
 ### How to Create a New Block
 
 1. **Create a New File:**  
-   Create a file for your block named after the provider (e.g., `pinecone.ts`) in the `/sim/blocks/blocks` directory.
+   Create a file for your block named after the provider (e.g., `pinecone.ts`) in the `/apps/sim/blocks/blocks` directory.
 
 2. **Create a New Icon:**
-   Create a new icon for your block in the `/sim/components/icons.tsx` file. The icon should follow the same naming convention as the block (e.g., `PineconeIcon`).
+   Create a new icon for your block in the `/apps/sim/components/icons.tsx` file. The icon should follow the same naming convention as the block (e.g., `PineconeIcon`).
 
 3. **Define the Block Configuration:**  
    Your block should export a constant of type `BlockConfig`. For example:
 
-   ```typescript:/sim/blocks/blocks/pinecone.ts
+   ```typescript:/apps/sim/blocks/blocks/pinecone.ts
    import { PineconeIcon } from '@/components/icons'
    import { PineconeResponse } from '@/tools/pinecone/types'
    import { BlockConfig } from '../types'
@@ -313,11 +313,11 @@ In addition, you will need to update the registries:
    ```
 
 4. **Register Your Block:**  
-   Add your block to the blocks registry (`/sim/blocks/registry.ts`):
+   Add your block to the blocks registry (`/apps/sim/blocks/registry.ts`):
 
-   ```typescript:/sim/blocks/registry.ts
+   ```typescript:/apps/sim/blocks/registry.ts
    import { PineconeBlock } from './blocks/pinecone'
-   
+
    // Registry of all available blocks
    export const registry: Record<string, BlockConfig> = {
      // ... existing blocks
@@ -333,7 +333,7 @@ In addition, you will need to update the registries:
 ### How to Create a New Tool
 
 1. **Create a New Directory:**  
-   Create a directory under `/sim/tools` with the same name as the provider (e.g., `/sim/tools/pinecone`).
+   Create a directory under `/apps/sim/tools` with the same name as the provider (e.g., `/apps/sim/tools/pinecone`).
 
 2. **Create Tool Files:**  
    Create separate files for each tool functionality with descriptive names (e.g., `fetch.ts`, `generate_embeddings.ts`, `search_text.ts`) in your tool directory.
@@ -344,7 +344,7 @@ In addition, you will need to update the registries:
 4. **Create an Index File:**  
    Create an `index.ts` file in your tool directory that imports and exports all tools:
 
-   ```typescript:/sim/tools/pinecone/index.ts
+   ```typescript:/apps/sim/tools/pinecone/index.ts
    import { fetchTool } from './fetch'
    import { generateEmbeddingsTool } from './generate_embeddings'
    import { searchTextTool } from './search_text'
@@ -355,7 +355,7 @@ In addition, you will need to update the registries:
 5. **Define the Tool Configuration:**  
    Your tool should export a constant with a naming convention of `{toolName}Tool`. The tool ID should follow the format `{provider}_{tool_name}`. For example:
 
-   ```typescript:/sim/tools/pinecone/fetch.ts
+   ```typescript:/apps/sim/tools/pinecone/fetch.ts
    import { ToolConfig, ToolResponse } from '../types'
    import { PineconeParams, PineconeResponse } from './types'
 
@@ -384,9 +384,9 @@ In addition, you will need to update the registries:
    ```
 
 6. **Register Your Tool:**  
-   Update the tools registry in `/sim/tools/index.ts` to include your new tool:
+   Update the tools registry in `/apps/sim/tools/index.ts` to include your new tool:
 
-   ```typescript:/sim/tools/index.ts
+   ```typescript:/apps/sim/tools/index.ts
    import { fetchTool, generateEmbeddingsTool, searchTextTool } from './pinecone'
    // ... other imports
 

.github/CONTRIBUTING.md

@@ -1,7 +1,7 @@
 ---
 name: Bug report
 about: Create a report to help us improve
-title: "[BUG]"
+title: '[BUG]'
 labels: bug
 assignees: ''
 ---
@@ -11,6 +11,7 @@ A clear and concise description of what the bug is.
 
 **To Reproduce**
 Steps to reproduce the behavior:
+
 1. Go to '...'
 2. Click on '....'
 3. Scroll down to '....'
@@ -23,4 +24,4 @@ A clear and concise description of what you expected to happen.
 If applicable, add screenshots to help explain your problem.
 
 **Additional context**
-Add any other context about the problem here.
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,7 +1,7 @@
 ---
 name: Feature request
 about: Suggest an idea for this project
-title: "[REQUEST]"
+title: '[REQUEST]'
 labels: feature
 assignees: ''
 ---
@@ -16,4 +16,4 @@ A clear and concise description of what you want to happen.
 A clear and concise description of any alternative solutions or features you've considered.
 
 **Additional context**
-Add any other context or screenshots about the feature request here.
+Add any other context or screenshots about the feature request here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -6,7 +6,6 @@
 | ------- | ------------------ |
 | 0.1.x   | :white_check_mark: |
 
-
 ## Reporting a Vulnerability
 
 We take the security of Sim Studio seriously. If you believe you've found a security vulnerability, please follow these steps:
@@ -16,11 +15,12 @@ We take the security of Sim Studio seriously. If you believe you've found a secu
 2. **Email us directly** at [email protected] with details of the vulnerability.
 
 3. **Include the following information** in your report:
+
    - Description of the vulnerability
    - Steps to reproduce
    - Potential impact
    - Any suggestions for mitigation
 
 4. We will acknowledge receipt of your vulnerability report within 48 hours and provide an estimated timeline for a fix.
 
-5. Once the vulnerability is fixed, we will notify you and publicly acknowledge your contribution (unless you prefer to remain anonymous).
+5. Once the vulnerability is fixed, we will notify you and publicly acknowledge your contribution (unless you prefer to remain anonymous).