Circle

Project management interface inspired by Linear. Built with Next.js and shadcn/ui, this application allows tracking of issues, projects and teams with a modern, responsive UI.

The BaseUI code is available on Square UI Pro.

🛠️ Technologies

• Framework: Next.js
• Language: TypeScript
• UI Components: shadcn/ui
• Styling: Tailwind CSS
• Database: Cloudflare D1 (SQLite)
• ORM: Drizzle ORM
• Deployment: Cloudflare Workers/Pages

📦 Installation

git clone https://github.com/ln-dev7/circle.git
cd circle

🚀 Getting Started

Install dependencies

npm install
# or
pnpm install

Start the development server

npm run dev
# or
pnpm dev

🗄️ Database Setup

This app uses Cloudflare D1 (SQLite) with Drizzle ORM for data persistence.

Create D1 Database

First, create a D1 database in your Cloudflare account:

npx wrangler d1 create circle-db

Copy the database_id from the output and update it in wrangler.jsonc:

"d1_databases": [
  {
    "binding": "DB",
    "database_name": "circle-db",
    "database_id": "YOUR_DATABASE_ID_HERE",
    "migrations_dir": "migrations"
  }
]

Run Migrations

Apply database migrations:

# For local development
npm run db:migrate:local

# For production
npm run db:migrate:remote

Seed the Database

Populate with initial data:

# For local development
npm run db:seed:local

# For production
npm run db:seed:remote

For more detailed database documentation, see lib/db/README.md.

☁️ Cloudflare Deployment

This app is configured to run on Cloudflare Workers/Pages using the @opennextjs/cloudflare adapter.

Preview locally with Cloudflare runtime

npm run preview

This command builds your app and serves it locally using the Workers runtime.

Deploy to Cloudflare

npm run deploy

This command builds and deploys your app to Cloudflare Workers. Make sure you have Wrangler configured with your Cloudflare account.

Configuration

The app includes the following Cloudflare-specific configurations:

• wrangler.jsonc - Cloudflare Workers configuration
• open-next.config.ts - OpenNext adapter configuration
• .gitignore - Excludes .open-next/, .wrangler/, and cloudflare-env.d.ts

For more information about deploying Next.js to Cloudflare, see the official documentation.

Star History