This document outlines the complete journey a new Prizm user will take from discovery to creating their first project.
Discovery
↓
Download & Install (0-2 minutes)
↓
Create First Project (1 minute)
↓
Write Hello World (2 minutes)
↓
Run Program (10 seconds)
↓
Explore Language Features
↓
Build Real Projects
# Step 1: Copy-paste one command
curl -fsSL https://raw.githubusercontent.com/Seigh-sword/Prizm/main/install.sh | bash
# Step 2: Reload shell (auto-prompted)
source ~/.bashrc
# Step 3: Verify (auto-done)
prizm --version
# Output: Prizm v0.1.0 on Linux x86-64
What Happens Behind the Scenes:
install.sh downloads~/.prizm/bin/ directorydist/linux-x64/prizm binaryIntel Mac:
curl -fsSL https://raw.githubusercontent.com/Seigh-sword/Prizm/main/install.sh | bash
source ~/.zshrc
Apple Silicon (M1/M2/M3):
curl -fsSL https://raw.githubusercontent.com/Seigh-sword/Prizm/main/install.sh | bash
source ~/.zshrc
Script automatically detects arm64 architecture and downloads the correct binary.
PowerShell as Administrator:
irm https://raw.githubusercontent.com/Seigh-sword/Prizm/main/install.bat | iex
What Happens:
install.bat downloads%USERPROFILE%\.prizm\bin\dist/windows-x64/prizm.exesetx# Initialize new project
./init.sh myapp
# Result:
# myapp/
# ├── src/center.pzm
# ├── libs/
# ├── assets/
# ├── build/
# ├── project.prizm
# ├── README.md
# └── .gitignore
# Prizm Main Entry Point
# This is the main file that runs when you execute: prizm run
output("Welcome to Prizm!"),
output("This is your main program file: src/center.pzm"),
# Example: Variables and output
var name: string = "Developer",
output("Hello, " + name),
# Example: Math operations
var result: int = math.add(5, 3),
output("5 + 3 = " + result),
# Example: Control flow
loop 3 {
output("Looping!"),
}
Option 1: Keep Default (Lazy)
cd myapp
prizm run
# Works immediately!
Option 2: Edit for Fun (Custom)
# Edit src/center.pzm
# Change name to their name
# Change numbers
# Save
prizm run
# See their changes!
# From project directory
prizm run
# Output:
# Welcome to Prizm!
# This is your main program file: src/center.pzm
# Hello, Developer
# 5 + 3 = 8
# Looping!
# Looping!
# Looping!
src/center.pzm# Format code
prizm pretty src/center.pzm
# Check for errors
prizm lint src/center.pzm
# Run with output
prizm run
Todo List
# Interactive todo list
# Uses arrays, control flow, file operations
API Client
# Fetches data from web API
# Uses http header and data parsing
File Manager
# List, create, delete files
# Uses file header
Calculator App
# GUI calculator
# Uses ui header and math operations
README.md (Main landing page)
├── Links to QUICKSTART.md (Begin here)
├── Links to DEPLOYMENT.md (Share your work)
├── Links to CONTRIBUTING.md (Help improve)
└── Links to PROJECT_SUMMARY.md (Technical overview)
QUICKSTART.md (Beginner guide)
├── Installation steps
├── First project
├── Language examples
└── "What's next?" section
CONTRIBUTING.md (Developer guide)
├── Bug reporting
├── Feature suggestions
├── Development setup
└── Code standards
DEPLOYMENT.md (Admin/DevOps guide)
├── Distribution methods
├── Package managers
├── Docker support
└── Continuous deployment
prizm lint suggestionprizm lint with helpful messagesNew Developer Discovers Prizm on GitHub
↓
Reads "No compilers required" promise
↓
Runs one-line install command
↓
Installation succeeds in 30 seconds
↓
Checks version - works!
↓
Runs init.sh to create project
↓
Project created with example code
↓
Runs "prizm run"
↓
Sees output immediately!
↓
Edits code, tries features
↓
Creates simple program
↓
Shares with friend
↓
Friend installs and runs it
↓
Both become Prizm users!
╔════════════════════════════════════╗
║ Installation Complete! ║
╚════════════════════════════════════╝
Quick Start:
1. Create project: ./init.sh myapp
2. Navigate: cd myapp
3. Run it: prizm run
Documentation:
- Quick Start: https://github.com/Seigh-sword/Prizm#quickstart
- Full Docs: https://github.com/Seigh-sword/Prizm/README.md
- Examples: Check source/example.pzm
Next Steps:
- Read QUICKSTART.md
- Try the example project
- Build something amazing!
Happy Coding!
The complete user journey from “never heard of Prizm” to “built my first program” should take:
Total time to success: ~1.5-2 hours
This positions Prizm as:
This document outlines the ideal user experience for Prizm. Every file and script supports this seamless journey.