📚 FluxSharp Documentation

Welcome to FluxSharp documentation! Here you'll find everything to learn and master the language.

🚀 Getting Started

First time? Follow this path:

1. QUICKSTART ⭐ - 5-minute introduction (START HERE!)
2. SYNTAX - Learn the basics
3. TYPES - Understand data types
4. Start coding! Use Error Guide if you get stuck

📖 Complete Guide

Core Language (Essentials)

• QUICKSTART - Your first program
• SYNTAX - Language syntax reference
• TYPES - All data types explained
• VARIABLES - Variables and constants
• OPERATORS - All operators

Functions & Classes (Next Level)

• FUNCTIONS - Write and call functions
• CLASSES - Object-oriented programming
• ARRAYS - Work with arrays

Control Flow & Built-ins

• Control Flow - if/else, loops, return
• STDLIB - Built-in math and print functions
• Async Await - Asynchronous programming

Help & Reference

• Error Guide - Understanding errors
• Build System - How compilation works

🎯 Learn By Task

"I want to..."

Write Hello World → QUICKSTART

Learn the syntax → SYNTAX → TYPES

Create variables → VARIABLES

Write functions → FUNCTIONS

Use classes → CLASSES

Use arrays → ARRAYS

Understand loops → Control Flow

Use math functions → STDLIB

Fix my errors → Error Guide

📊 Quick Facts

File Extension: .fsh (FluxSharp)

Data Types:

• int - 64-bit integer
• float - 32-bit float (use 3.14f syntax)
• double - 64-bit double
• string - Text
• bool - true/false
• byte - Single byte
• long, uint, ulong - Other numeric types

Comments:

• // single line
• / multi-line /

Key Keywords:

• class - Define a class
• public, private - Visibility
• return - Return from function
• if, else, for, while - Control flow
• break, continue - Loop control
• new - Create instance
• async, await - Async operations

💡 Quick Examples

Hello World:

class Main {
    public void main() {
        print("Hello!");
    }
}

Variables:

int x = 10;
float f = 3.14f;
string name = "Alice";

Function:

public int add(int a, int b) {
    return a + b;
}

Class:

class Calculator {
    int value = 0;
    public void add(int x) {
        value = value + x;
    }
}

Loop:

for (int i = 0; i < 10; i = i + 1) {
    print(i);
}

Math:

int max_val = max(10, 20);
double root = sqrt(16.0);

🆘 Getting Help

Got an error? → Check Error Guide

Don't understand syntax? → See [SYNTAX]/docs/?page=02-language/SYNTAX

How do types work? → Read [TYPES]/docs/?page=02-language/TYPES

Building/compiling issues? → See Build System

📚 Document Quality

All guides are:

• ✅ Written in clear English
• ✅ Organized by topic
• ✅ Include practical examples
• ✅ Cross-referenced
• ✅ Easy to search

🎓 Learning Recommendations

Beginner (30 min):

1. QUICKSTART.md
2. TYPES.md
3. Try simple programs

Intermediate (1-2 hours):

1. VARIABLES.md
2. FUNCTIONS.md
3. CONTROL_FLOW.md
4. Build small programs

Advanced (2+ hours):

1. CLASSES.md
2. ARRAYS.md
3. STDLIB.md
4. ASYNC_AWAIT.md
5. Create projects

🔍 Search by Topic

✨ What's Included

✅ Complete language reference ✅ Beginner-friendly tutorials ✅ Real code examples ✅ Error explanations ✅ Best practices ✅ Common patterns

🚀 Next Steps

1. Start: Read [QUICKSTART]/docs/?page=01-quickstart/QUICKSTART
2. Learn: Follow guides in order
3. Code: Try the examples
4. Build: Create your own programs
5. Reference: Come back anytime

Let's code! 🎉

Start with [QUICKSTART]/docs/?page=01-quickstart/QUICKSTART →