Tutorials & Guides

Tutorials & Guides

Learn TW with our comprehensive tutorials and step-by-step guides.

Getting Started Tutorials

Quick Start Guide (5 minutes)

Get up and running with TW in just 5 minutes.

1. Create an account at twhelpcenter.com/signup
2. Generate API key from Settings > API Keys
3. Install SDK for your preferred language
4. Make your first API call

import { TWAPI } from '@tw/sdk';

const api = new TWAPI({
  apiKey: process.env.TW_API_KEY
});

// Create your first dataset
const dataset = await api.datasets.create({
  name: 'my-first-dataset',
  description: 'Getting started with TW'
});

console.log('Dataset created:', dataset.id);

Your First Dataset (10 minutes)

Learn how to create, populate, and query a dataset.

Step 1: Create the dataset

const dataset = await api.datasets.create({
  name: 'customers',
  schema: {
    columns: [
      { name: 'id', type: 'integer', primaryKey: true },
      { name: 'email', type: 'string', unique: true },
      { name: 'name', type: 'string' },
      { name: 'created_at', type: 'timestamp', default: 'now()' }
    ]
  }
});

Step 2: Insert data

await api.datasets.insertRows(dataset.id, {
  rows: [
    { id: 1, email: 'alice@example.com', name: 'Alice' },
    { id: 2, email: 'bob@example.com', name: 'Bob' }
  ]
});

Step 3: Query data

const customers = await api.datasets.query(dataset.id, {
  select: ['id', 'name', 'email'],
  orderBy: { created_at: 'desc' }
});

Intermediate Tutorials

Building a Data Pipeline (30 minutes)

Create an automated data pipeline that ingests, transforms, and loads data.

| Step | Task | Duration | |------|------|----------| | 1 | Set up data source | 5 min | | 2 | Create transformation logic | 10 min | | 3 | Configure destination | 5 min | | 4 | Set up automation | 5 min | | 5 | Test and deploy | 5 min |

Implementing Access Control (20 minutes)

Learn how to implement role-based access control with policies.

// Create roles
const adminRole = await api.roles.create({
  name: 'admin',
  permissions: ['*']
});

const analystRole = await api.roles.create({
  name: 'analyst',
  permissions: ['datasets.read', 'datasets.query']
});

// Create policy
const policy = await api.policies.create({
  name: 'Dataset Access Control',
  rules: [
    {
      resource: 'datasets.sensitive_data',
      action: 'read',
      effect: 'deny',
      condition: 'user.role != "admin"'
    }
  ]
});

Setting Up Webhooks (15 minutes)

Configure webhooks to receive real-time event notifications.

// Create webhook
const webhook = await api.webhooks.create({
  url: 'https://your-app.com/webhooks/timesworld',
  events: [
    'dataset.created',
    'dataset.updated',
    'policy.violated'
  ],
  secret: 'your-webhook-secret'
});

// Handle webhook in your app
app.post('/webhooks/timesworld', (req, res) => {
  const event = req.body;
  const signature = req.headers['x-timesworld-signature'];

  // Verify signature
  if (!verifySignature(event, signature, webhook.secret)) {
    return res.status(401).send('Invalid signature');
  }

  // Handle event
  switch (event.type) {
    case 'dataset.updated':
      handleDatasetUpdate(event.data);
      break;
    case 'policy.violated':
      handlePolicyViolation(event.data);
      break;
  }

  res.status(200).send('OK');
});

Advanced Tutorials

Optimizing Query Performance (45 minutes)

Learn advanced techniques for optimizing query performance.

Topics covered:

• Index optimization
• Query planning
• Batch operations
• Caching strategies
• Pagination best practices

Custom Integration Development (60 minutes)

Build a custom integration from scratch.

import { CustomIntegration } from '@tw/sdk';

class SalesforceIntegration extends CustomIntegration {
  name = 'salesforce';

  async authenticate(config) {
    const auth = await this.oauth2({
      clientId: config.clientId,
      clientSecret: config.clientSecret,
      authUrl: 'https://login.salesforce.com/services/oauth2/authorize',
      tokenUrl: 'https://login.salesforce.com/services/oauth2/token'
    });

    this.accessToken = auth.access_token;
    this.instanceUrl = auth.instance_url;
  }

  async sync(options) {
    const accounts = await this.fetchAccounts();
    await this.saveToDataset('salesforce_accounts', accounts);
  }

  async fetchAccounts() {
    const response = await fetch(
      `${this.instanceUrl}/services/data/v57.0/query?q=SELECT+Id,Name,Type+FROM+Account`,
      {
        headers: { 'Authorization': `Bearer ${this.accessToken}` }
      }
    );

    return response.json();
  }
}

// Register integration
Integration.register(new SalesforceIntegration());

Multi-Region Deployment (45 minutes)

Deploy TW across multiple regions for optimal performance.

Learning objectives:

• Understanding regional deployments
• Configuring data replication
• Managing regional failover
• Optimizing for latency

Video Tutorials

Beginner Series (10 videos)

1. Introduction to TW (5:00)
2. Creating Your First Dataset (8:00)
3. Understanding Policies (12:00)
4. Working with APIs (15:00)
5. Data Import & Export (10:00)
6. Basic Integrations (12:00)
7. User Management (8:00)
8. Dashboard Overview (10:00)
9. Monitoring & Alerts (12:00)
10. Best Practices (15:00)

Advanced Series (15 videos)

• Advanced Query Techniques (20:00)
• Custom Policy Development (25:00)
• Building Integrations (30:00)
• Performance Optimization (25:00)
• Security Deep Dive (30:00)
• And 10 more...

Hands-On Labs

Lab 1: Build a Customer Portal

Duration: 2 hours Difficulty: Intermediate

Build a complete customer portal with:

• User authentication
• Dataset management
• Real-time updates
• Custom dashboards

Lab 2: E-commerce Analytics Pipeline

Duration: 3 hours Difficulty: Advanced

Create an analytics pipeline for e-commerce:

• Data ingestion from multiple sources
• Real-time transformation
• Advanced analytics
• Automated reporting

Use Case Guides

| Use Case | Industry | Complexity | Duration | |----------|----------|------------|----------| | Customer Data Platform | Retail | Intermediate | 2 hours | | Financial Reporting | Finance | Advanced | 3 hours | | IoT Data Management | Manufacturing | Advanced | 4 hours | | Healthcare Records | Healthcare | Expert | 5 hours |

Code Examples Repository

Browse 100+ code examples on GitHub:

• Complete application templates
• Integration samples
• Policy examples
• Utility functions
• Testing strategies

Interactive Tutorials

Try our interactive tutorials in the browser:

• No setup required
• Real-time feedback
• Step-by-step guidance
• Progress tracking

Learning Paths

Data Engineer Path

1. Dataset Fundamentals
2. Data Transformation
3. Pipeline Development
4. Performance Optimization
5. Production Best Practices

Application Developer Path

1. API Fundamentals
2. Authentication & Security
3. Integration Development
4. Error Handling
5. Deployment Strategies

Security Administrator Path

1. Access Control Basics
2. Policy Development
3. Audit & Compliance
4. Security Best Practices
5. Incident Response

Best Practices Guides

• Data modeling best practices
• Security hardening guide
• Performance optimization guide
• Error handling patterns
• Testing strategies

Community Tutorials

Learn from community-contributed tutorials:

• Real-world use cases
• Creative solutions
• Integration examples
• Tips and tricks

Certification Programs

TW Certified Developer

• Self-paced learning
• Hands-on labs
• Final exam
• Official certification

TW Certified Administrator

• Advanced topics
• Real-world scenarios
• Best practices
• Expert certification

Need Help?

• Join our Community Forum
• Watch Webinars
• Contact support for personalized training