jac-client 0.1.0

No project description provided

Jac Client

Build full-stack web applications with Jac - one language for frontend and backend.

Jac Client enables you to write React-like components, manage state, and build interactive UIs all in Jac. No need for separate frontend frameworks, HTTP clients, or complex build configurations.

---

✨ Features

• Single Language: Write frontend and backend in Jac
• No HTTP Client: Use __jacSpawn() instead of fetch/axios
• Reactive State: Built-in state management with createState()
• Component-Based: Build reusable UI components with JSX
• Graph Database: Built-in graph data model eliminates need for SQL/NoSQL
• Type Safety: Type checking across frontend and backend
• Vite-Powered: Optimized production bundles with Vite

---

🚀 Quick Start

Installation

pip install jac-client

Create a New App

jac create_jac_app my-app
cd my-app
jac serve app.jac

Visit http://localhost:8000 to see your app!

---

📚 Documentation

For detailed guides and tutorials, see the docs folder:

• Getting Started Guide - Complete beginner's guide
• Routing - Multi-page applications with initRouter()
• Lifecycle Hooks - Using onMount() for initialization
• Advanced State - Managing complex state
• Imports - Importing libraries, Jac files, and JavaScript modules

---

💡 Example

cl {
    let [count, setCount] = createState({"value": 0});

    def Counter() -> any {
        s = count();
        return <div>
            <h1>Count: {s.value}</h1>
            <button onClick={lambda -> None {
                setCount({"value": s.value + 1});
            }}>
                Increment
            </button>
        </div>;
    }

    def jac_app() -> any {
        return Counter();
    }
}

---

🔧 Requirements

• Python: 3.12+
• Node.js: For npm and Vite
• Jac Language: jaclang (installed automatically)

---

🛠️ How It Works

Jac Client is a plugin that:

1. Compiles your .jac client code to JavaScript
2. Bundles dependencies with Vite for optimal performance
3. Provides a runtime for reactive state and components
4. Integrates seamlessly with Jac's backend graph operations

---

📖 Learn More

• Full Documentation: See docs/ for comprehensive guides
• Examples: Check jac_client/examples/ for working examples
• Issues: Report bugs on GitHub Issues

---

📄 License

MIT License - see LICENSE file.

---

Happy coding with Jac! 🎉