eBright Learning — Claude Code & Cloudflare Deployment

Claude Code

Claude Code is an AI coding assistant that lives in your terminal. It reads your codebase, writes code, runs commands, and helps you ship faster.

🤖

AI in your terminal

Talk to Claude directly from your project folder using the claude command.

📂

Understands your codebase

Claude reads your files, understands context, and makes changes across multiple files at once.

⚡

Runs commands for you

Claude can run terminal commands, install packages, run tests, and fix errors automatically.

Getting Started

Install Claude Code

npm install -g @anthropic-ai/claude-code

Authenticate (first run — opens browser)
```
claude
```
Start a session inside your project folder
```
cd your-project
claude
```

Key Commands

claudeStart interactive session

/helpShow all commands

/clearClear conversation

/compactSummarise context

claude "fix this bug"One-shot task

Cloudflare Pages

Cloudflare Pages is a free hosting platform that deploys your site to a global CDN in seconds — connected directly to your GitHub repo.

🆓

Free hosting

Unlimited free deployments, custom domains, and HTTPS included at no cost.

🌍

Global CDN

Your site is served from 300+ data centres worldwide — blazing fast everywhere.

🔗

Git-connected deploys

Push to GitHub and your site deploys automatically. Every PR gets a preview URL.

Setup Steps

Create a Cloudflare account at dash.cloudflare.com
Connect your GitHub repo — go to Workers & Pages → Create → Pages → Connect to Git
Set build settings — Build command: (leave empty), Output directory: /
Deploy — Cloudflare builds and gives you a live *.pages.dev URL instantly

Config File

wrangler.toml

name = "ebrightv2"
compatibility_date = "2024-01-01"
pages_build_output_dir = "."

CI/CD Pipeline

Automate your deploy workflow so every commit, push, and PR triggers a live preview — and merging to main updates production automatically.

Commit

→

Push Branch

→

Open PR

→

Preview Deploy

→

Merge to main

→

Production Deploy

Step-by-Step Walkthrough

Make changes locally and commit

git add .
git commit -m "feat: add new section"

Push your branch
```
git push origin your-branch-name
```
Open a Pull Request on GitHub — click "Compare & pull request"
GitHub Actions triggers — a preview URL is automatically posted as a PR comment
Review, approve, and merge — production deploys to ebrightv2-askbard.pages.dev automatically

GitHub Actions Workflow

wrangler.toml

name = "ebrightv2"
compatibility_date = "2024-01-01"
pages_build_output_dir = "."

.github/workflows/deploy.yml

name: Deploy to Cloudflare Pages

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      deployments: write
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
      - name: Deploy to Cloudflare Pages
        uses: cloudflare/pages-action@v1
        with:
          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
          projectName: ebrightv2
          directory: .
          gitHubToken: ${{ secrets.GITHUB_TOKEN }}

Required GitHub Secrets:

CLOUDFLARE_API_TOKEN — create at dash.cloudflare.com → My Profile → API Tokens → Create Token → "Edit Cloudflare Workers" template
CLOUDFLARE_ACCOUNT_ID — found on the right sidebar of your Cloudflare dashboard home