← Back to Home

Technical Reference

Technical specifications and reference materials


# Technical Reference

## System Requirements

- **Server Requirements**:
  - Node.js v14+
  - Firebase account
  - Git repository
- **Development Environment**:
  - npm or yarn
  - Code editor (VS Code recommended)
  - Firebase CLI

## API Reference

### Authentication Endpoints

```javascript
// Login
await firebase.auth().signInWithEmailAndPassword(email, password)

// Logout
await firebase.auth().signOut()

// Get current user
const user = firebase.auth().currentUser
```

### Content Management

```javascript
// Get document by slug
const doc = await getDocBySlug(slug)

// Update document
await saveContent(type, slug, content, title)
```

## File Structure

```
├── app/
│   ├── docs/             # Documentation MDX files
│   ├── (protected)/      # Protected routes
│   └── api/              # API endpoints
├── components/           # React components
├── lib/                  # Utility functions
└── knowledgebase/        # KB markdown files
```

## Build Process

1. **Development**:

   ```bash
   npm run dev
   ```

2. **Production Build**:

   ```bash
   npm run build
   ```

3. **Deployment**:
   ```bash
   ./deploy.sh
   ```

## Troubleshooting

### Common Build Errors

- **Module not found**: Check import paths and dependencies
- **Firebase authentication failure**: Verify credentials and permissions
- **Static generation errors**: Check API routes for server-only code

### Deployment Issues

- **Firebase login errors**: Re-authenticate with `firebase login`
- **Build failures**: Clean build directories with `rm -rf .next out`
- **Missing files**: Verify output directory structure