import { useState } from 'react' import { Tabs, TabsContent, TabsList, TabsTrigger } from '@/components/ui/tabs' import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card' import { ScrollArea } from '@/components/ui/scroll-area' import { Badge } from '@/components/ui/badge' import { Separator } from '@/components/ui/separator' import { Input } from '@/components/ui/input' import { BookOpen, MapPin, FileCode, CheckCircle, Clock, Sparkle, Code, Database, Tree, PaintBrush, Flask, Play, Cube, Wrench, Gear, Package, Rocket, Target, Lightbulb, MagnifyingGlass, GitBranch } from '@phosphor-icons/react' export function DocumentationView() { const [activeTab, setActiveTab] = useState('readme') const [searchQuery, setSearchQuery] = useState('') return (
Low-Code Next.js App Builder with AI
CodeForge is a comprehensive visual low-code platform for generating production-ready Next.js applications. It combines the power of visual designers with direct code editing, AI-powered generation, and a complete full-stack development toolkit.
Navigate to the Models tab and create your database schema using the visual designer or describe your data model to the AI.
Use the Components tab to build your UI hierarchy visually or let the AI generate component structures based on your requirements.
Head to the Styling tab to create custom color palettes, manage theme variants (light/dark), and configure typography.
Configure your Flask API in the Flask API tab by creating blueprints and endpoints with full CORS and authentication support.
Click Export Project to generate all files including Next.js pages, Prisma schemas, Flask backend, tests, and configuration files ready for deployment.
CodeForge integrates OpenAI across every designer to accelerate development:
💡 Use the AI Generate feature to quickly scaffold entire applications from descriptions
💡 The Error Repair tab automatically scans and fixes common issues - check it before exporting
💡 Create multiple theme variants (light, dark, custom) in the Styling tab for complete theme support
💡 Test your components with Storybook stories before writing full E2E tests
💡 Flask blueprints help organize your API endpoints by feature or resource
Features delivered and planned for CodeForge development
AI agent configuration and service architecture
CodeForge uses a modular AI service architecture that integrates OpenAI's GPT models across all features. Each designer has specialized prompts and validation logic to ensure high-quality generated code.
All AI prompts include relevant project context such as existing models, components, and theme configurations to ensure generated code integrates seamlessly.
Prompts specify exact output formats (JSON, TypeScript, Python) with strict schemas to ensure parseable and valid responses.
Generated code follows Next.js, React, and Flask best practices through detailed prompt instructions and post-processing validation.
Fallback mechanisms and retry logic ensure graceful degradation when AI services are unavailable or responses are malformed.
Offline-first experience with native-like capabilities
CodeForge is a fully-featured Progressive Web App that can be installed on any device and works offline. With intelligent caching, automatic updates, and native app-like features, you can build applications anywhere, anytime.
Install on desktop or mobile for quick access from your home screen or applications menu
Work without internet connection; changes sync automatically when you reconnect
Get notified when new versions are available with one-click updates
Opt-in to receive updates about builds, errors, and new features
Quick access to Dashboard, Code Editor, and Models from your OS
Share code files directly to CodeForge from other apps
Navigate to the PWA tab to manage all Progressive Web App features:
Check if app is installed and trigger installation if available
Real-time online/offline indicator with connectivity information
Toggle notifications and manage permissions
View cache size, service worker status, and clear cached data
Install pending updates when new versions are available
Custom Material UI components with Sass
CodeForge includes a comprehensive Sass-based styling system for non-standard Material UI components. This system provides pre-built components, utilities, mixins, and animations that extend beyond the standard Material UI component library.
src/styles/_variables.scss
Color palettes, spacing scales, typography, transitions, and other design tokens
src/styles/_utilities.scss
Mixins and functions for responsive design, colors, typography, and layout helpers
src/styles/_animations.scss
Keyframe animations and animation utility classes for transitions and effects
src/styles/material-ui-custom.scss
Custom Material UI component styles with variants and states
src/styles/main.scss
Main entry point that imports all Sass modules and provides layout components
@include respond-to($breakpoint)
Generate media queries for xs, sm, md, lg, xl, 2xl breakpoints
{`@include respond-to('lg') {
padding: 2rem;
}`}
@include elevation($level)
Apply box shadows with levels 1-4
{`@include elevation(2);`}
@include glassmorphism($blur, $opacity)
Create frosted glass effects with backdrop blur
{`@include glassmorphism(16px, 0.1);`}
get-color($palette, $shade)
Access colors from predefined palettes (primary, secondary, accent, success, error, warning)
{`color: get-color('primary', 500);`}
@include truncate($lines)
Truncate text with ellipsis after specified lines
{`@include truncate(2);`}
@include show-scrollbar($track, $thumb)
Style webkit scrollbars with custom colors
{`@include show-scrollbar(rgba(0,0,0,0.1), rgba(0,0,0,0.3));`}
{`import './styles/main.scss'
function MyComponent() {
return (
Card Title
Card content
)
}`}
{`@use './styles/utilities' as *;
@use './styles/variables' as *;
.my-custom-component {
@include elevation(2);
@include responsive-padding(spacing('6'));
background: get-color('primary', 500);
@include respond-to('md') {
@include elevation(3);
}
&:hover {
@include glassmorphism(12px, 0.15);
}
}`}
Complete deployment automation for multiple platforms
CodeForge includes production-ready CI/CD configurations for GitHub Actions, GitLab CI, Jenkins, and CircleCI. Each pipeline includes linting, testing, security scanning, Docker image building, and automated deployment workflows.
All CI/CD configurations follow a similar multi-stage pipeline structure:
Dockerfile
Multi-stage build with Node.js builder and Nginx runtime
nginx.conf
Production Nginx configuration with health checks and caching
docker-compose.yml
Local development and deployment orchestration
.dockerignore
Optimized build context by excluding unnecessary files
{`# Build image locally
docker build -t codeforge:local .
# Run container
docker run -p 3000:80 codeforge:local
# Use docker-compose
docker-compose up -d
# Pull from registry
docker pull ghcr.io//:latest`}
| Variable | Description | Required |
|---|---|---|
NODE_VERSION |
Node.js version (default: 20) | No |
REGISTRY |
Docker registry URL (default: ghcr.io) | No |
STAGING_WEBHOOK_URL |
Webhook for staging deployments | Optional |
PRODUCTION_WEBHOOK_URL |
Webhook for production deployments | Optional |
CODECOV_TOKEN |
Codecov integration token | Optional |
SLACK_WEBHOOK |
Slack webhook for notifications | Optional |
Production branch - deploys to production environment (manual approval required)
Development branch - automatically deploys to staging environment
Feature branches - runs tests only, no deployment
Version tags - triggers release workflow with artifacts and changelog
Select GitHub Actions, GitLab CI, Jenkins, or CircleCI based on your infrastructure
Add required environment variables and secrets in your platform's settings
Push code to main or develop branch to trigger the CI/CD pipeline
View pipeline status, test results, and deployment logs in your platform's dashboard
CI_CD_GUIDE.md - Detailed setup guide for all platforms
.github/workflows/ - GitHub Actions workflows
.gitlab-ci.yml - GitLab CI configuration
Jenkinsfile - Jenkins pipeline definition
.circleci/config.yml - CircleCI configuration
{file}
{description}
Key Features:
{description}
{description}
{cls}
))}
{name}
{description}
{description}
{description}
{description}
{filename}
{path}
{description}
Key Features: