st-setup-project

Set Up Smalltalk Project Boilerplate

Create a complete Smalltalk project structure with BaselineOf, Core package, and Tests package.

When to Use This Skill

• User asks to "create a new project", "start a Smalltalk project", or "set up project structure"
• No src/ directory or .project file exists in the current directory
• User provides a project name and wants to begin development

Project Name Rules

• PascalCase required: Must start with uppercase, alphanumeric only
• Valid: MyProject, RedisClient, JSONParser
• Invalid: my-project, my_project, myProject

If no name provided: Ask with AskUserQuestion: "What is your project name? (Use PascalCase like MyProject)"

Pre-flight Checks

1. Validate PascalCase:

if [[ ! "$PROJECT_NAME" =~ ^[A-Z][a-zA-Z0-9]*$ ]]; then
  echo "Error: Project name must be in PascalCase (e.g., MyProject, RedisClient)"
  exit 1
fi

2. Check for existing project:

if [ -d "src" ] && [ "$(find src -mindepth 1 -maxdepth 1 -type d 2>/dev/null | wc -l)" -gt 0 ]; then
  echo "Error: Project already exists (src/ directory contains packages)"
  exit 1
fi

Created Structure

MyProject/
├── .project                          # srcDirectory: 'src'
└── src/
    ├── .properties                   # format: tonel
    ├── BaselineOfMyProject/
    │   ├── package.st
    │   └── BaselineOfMyProject.class.st
    ├── MyProject-Core/
    │   └── package.st
    └── MyProject-Tests/
        └── package.st

Implementation

Run the setup script with the validated project name. See Complete Setup Script for the full bash implementation.

Key files created:

.project (STON format with single quotes):

{
	'srcDirectory' : 'src'
}

src/.properties (Tonel format declaration):

{
	#format : #tonel
}

BaselineOf class defines package dependencies and groups:

• Core group: ProjectName-Core
• Tests group: ProjectName-Tests (requires Core)
• all group: Core + Tests
• default group: Core only