Introduction

Turn your ideas into full stack applications with AI-powered code generation.

What is ByteMason?

ByteMason is an intelligent development tool that transforms natural language descriptions into complete full stack web applications. It’s designed for both beginners and experienced developers who want to:

• Build full-stack Next.js applications quickly
• Focus on business logic instead of boilerplate
• Maintain high code quality and best practices
• Automate repetitive development tasks

Prerequisites

• Python 3.10 or higher
• Anthropic API key
• OpenAI API key

Quick Start

# Install ByteMason
pip install bytemason
 
# Set up environment
export ANTHROPIC_API_KEY=your_key
export OPENAI_API_KEY=your_key
 
# Create and generate your app
berry new my-shop
cd my-shop
berry plan "Create an online shop with product catalog, 
shopping cart, and user authentication"
berry code ./spec/specification.json

How It Works

ByteMason uses a three-phase approach:

1. Understanding - AI analyzes your requirements
2. Planning - Generates detailed technical specifications
3. Building - Creates and validates your application

Core Features

AI-Powered Development

• Natural language to code conversion
• Automatic error detection and fixing
• Smart code generation and repair

Modern Stack

• Next.js 14 with App Router
• Supabase for backend
• TypeScript for type safety
• shadcn/ui components

Developer Experience

• Clean, maintainable code
• Automated testing setup
• Type-safe database queries
• Modern development patterns

Documentation Structure

Getting Started

• Installation - Set up ByteMason on your machine
• Quick Start - Build your first app in minutes
• Core Concepts - Understand how ByteMason works

Guides

• Building Your First App - Step-by-step tutorial
• Database Management - Working with Supabase
• Local Development - Contributing to ByteMason

Reference

• CLI Commands - Complete command reference
• Configuration - Configure ByteMason
• API Reference - API documentation

Example Applications

ByteMason can help you build:

Web Applications

• E-commerce platforms
• Content management systems
• Social networking apps
• Admin dashboards
• Booking systems

Features

• User authentication
• Database CRUD operations
• Real-time updates
• File uploads
• API integrations

Local Development

Want to contribute or modify ByteMason? It’s easy to get started:

# Clone and setup
git clone https://github.com/lumiralabs/bytemason.git
cd bytemason
 
# Create virtual environment (Python 3.10 or higher)
python -m venv venv
source venv/bin/activate  # On Windows: .\venv\Scripts\activate
 
# Install dependencies
pip install -e .
 
# Set environment variables
cp .env.example .env
# Add your API keys to .env

Learn more about local development →

Best Practices

1. Writing Effective Prompts

   # Be specific about features
   berry plan "Build a blog with categories, tags, 
   comments, and email notifications for new posts"

2. Working with Generated Code

   • Review generated files
   • Make incremental changes
   • Use version control

3. Database Management

   • Review migrations
   • Test data relationships
   • Validate security rules

Community and Support

• GitHub Repository 
• Documentation Issues 

Contributing

We welcome contributions! See our Contributing Guide to get started.