First Complete Application

This guide walks you through building your first complete Pytigon application from scratch.

What We'll Build

A simple task management application with: - A database table for tasks - List and edit views - A form for creating/editing tasks - Basic permissions

Step 1: Create a New Project

pytigon create my_tasks
cd my_tasks

This creates the project structure with a default application.

Step 2: Define the Data Model

Create prj/my_tasks/models.py:

from django.db import models
from pytigon_lib.schdjangoext.models import JSONModel

class Task(JSONModel):
    title = models.CharField(max_length=200)
    description = models.TextField(blank=True)
    priority = models.IntegerField(default=0)
    completed = models.BooleanField(default=False)
    due_date = models.DateField(null=True, blank=True)
    created_at = models.DateTimeField(auto_now_add=True)

    class Meta:
        ordering = ['priority', '-created_at']

    def __str__(self):
        return self.title

Step 3: Configure the Application

Create prj/my_tasks/apps.py:

APPS = ['my_tasks']
PUBLIC = True

Step 4: Define Views

Pytigon's schdevtools IDE can generate views automatically, or you can define them manually in the .prj project file. The IDE approach:

  1. Start Pytigon: pytigon run
  2. Navigate to schdevtools
  3. Open your project
  4. Go to the Tables section
  5. Click "Add Table" and select your Task model
  6. Configure columns, sort order, and permissions
  7. Save — views are generated automatically

Step 5: Run and Test

pytigon run

Visit http://localhost:8000/ and navigate to your application. You should see: - A list view showing all tasks - Add/edit/delete buttons - Your configured columns

Step 6: Add Forms (Optional)

In schdevtools, go to Forms and create a form for the Task model:

  1. Add fields: title (required), description (textarea), priority (numeric), completed (checkbox), due_date (date)
  2. Choose a layout (single column, two columns, tabs)
  3. Save — the form is generated

Next Steps

  • Add validation rules to your model
  • Create custom actions (e.g., "Mark All Complete")
  • Add permissions for different user roles
  • Create templates for custom rendering
  • Export data to PDF/Excel

See the Quick Start guide for broader overview, and the Developer Tools section for IDE documentation.

?: FirstCompleteApplicatio ?: FirstCompleteApplicatio