Work done to implement the "product" focused front end design
Go to file
2025-06-12 22:39:55 -04:00
.cursor/rules Added project pages and cards, most of the screens in chris samuels figma design document. Still need to implement project initialization modal and walkthrough, connect to backend and connect to wallet (maybe be beyond scope of this project) 2025-05-06 16:42:13 -04:00
.github Added project pages and cards, most of the screens in chris samuels figma design document. Still need to implement project initialization modal and walkthrough, connect to backend and connect to wallet (maybe be beyond scope of this project) 2025-05-06 16:42:13 -04:00
.vscode Added project pages and cards, most of the screens in chris samuels figma design document. Still need to implement project initialization modal and walkthrough, connect to backend and connect to wallet (maybe be beyond scope of this project) 2025-05-06 16:42:13 -04:00
apps Fixed the time not showing on the project card issue 2025-06-12 22:39:55 -04:00
docs/architecture/wallet_migration Added project pages and cards, most of the screens in chris samuels figma design document. Still need to implement project initialization modal and walkthrough, connect to backend and connect to wallet (maybe be beyond scope of this project) 2025-05-06 16:42:13 -04:00
scripts Added project pages and cards, most of the screens in chris samuels figma design document. Still need to implement project initialization modal and walkthrough, connect to backend and connect to wallet (maybe be beyond scope of this project) 2025-05-06 16:42:13 -04:00
services Added project pages and cards, most of the screens in chris samuels figma design document. Still need to implement project initialization modal and walkthrough, connect to backend and connect to wallet (maybe be beyond scope of this project) 2025-05-06 16:42:13 -04:00
standards Added project pages and cards, most of the screens in chris samuels figma design document. Still need to implement project initialization modal and walkthrough, connect to backend and connect to wallet (maybe be beyond scope of this project) 2025-05-06 16:42:13 -04:00
.gitignore Added project pages and cards, most of the screens in chris samuels figma design document. Still need to implement project initialization modal and walkthrough, connect to backend and connect to wallet (maybe be beyond scope of this project) 2025-05-06 16:42:13 -04:00
.npmrc Added project pages and cards, most of the screens in chris samuels figma design document. Still need to implement project initialization modal and walkthrough, connect to backend and connect to wallet (maybe be beyond scope of this project) 2025-05-06 16:42:13 -04:00
biome.json Added project pages and cards, most of the screens in chris samuels figma design document. Still need to implement project initialization modal and walkthrough, connect to backend and connect to wallet (maybe be beyond scope of this project) 2025-05-06 16:42:13 -04:00
lefthook.yaml Added project pages and cards, most of the screens in chris samuels figma design document. Still need to implement project initialization modal and walkthrough, connect to backend and connect to wallet (maybe be beyond scope of this project) 2025-05-06 16:42:13 -04:00
LICENSE Added project pages and cards, most of the screens in chris samuels figma design document. Still need to implement project initialization modal and walkthrough, connect to backend and connect to wallet (maybe be beyond scope of this project) 2025-05-06 16:42:13 -04:00
next-agent-01.md Added project pages and cards, most of the screens in chris samuels figma design document. Still need to implement project initialization modal and walkthrough, connect to backend and connect to wallet (maybe be beyond scope of this project) 2025-05-06 16:42:13 -04:00
package.json Connected to backend and fixed up UI changes, created a test-connection page 2025-06-12 16:16:08 -04:00
pnpm-lock.yaml Connected to backend and fixed up UI changes, created a test-connection page 2025-06-12 16:16:08 -04:00
pnpm-workspace.yaml Added project pages and cards, most of the screens in chris samuels figma design document. Still need to implement project initialization modal and walkthrough, connect to backend and connect to wallet (maybe be beyond scope of this project) 2025-05-06 16:42:13 -04:00
readme.md Modified readme to contain instructions to use frontend as it currently stands 2025-05-12 18:43:06 -04:00
tsconfig.base.json Added project pages and cards, most of the screens in chris samuels figma design document. Still need to implement project initialization modal and walkthrough, connect to backend and connect to wallet (maybe be beyond scope of this project) 2025-05-06 16:42:13 -04:00
tsconfig.json Added project pages and cards, most of the screens in chris samuels figma design document. Still need to implement project initialization modal and walkthrough, connect to backend and connect to wallet (maybe be beyond scope of this project) 2025-05-06 16:42:13 -04:00
turbo.json Added project pages and cards, most of the screens in chris samuels figma design document. Still need to implement project initialization modal and walkthrough, connect to backend and connect to wallet (maybe be beyond scope of this project) 2025-05-06 16:42:13 -04:00

Laconic Frontend

Prerequisites

Ensure you have the following installed:

Project Structure

This monorepo contains several packages:

  • apps/deploy-fe: Frontend Next.js application
  • apps/backend: Express.js backend API
  • apps/deployer: Deployment service
  • services/gql-client: GraphQL client library
  • services/ui: Shared UI components
  • services/typescript-config: Shared TypeScript configurations

Getting Started

1. Clone the repository

git clone https://github.com/yourusername/qwrk-laconic-core-develop.git
cd qwrk-laconic-core-develop

2. Install dependencies

pnpm install

3. Configure environment variables

Create a .env.local file in the apps/deploy-fe directory:

NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_clerk_key
CLERK_SECRET_KEY=your_clerk_secret
NEXT_PUBLIC_WALLET_IFRAME_URL=http://localhost:4000
NEXT_PUBLIC_LACONICD_CHAIN_ID=laconic-testnet-2
NEXT_PUBLIC_API_URL=http://localhost:8000
NEXT_PUBLIC_GITHUB_FALLBACK_TOKEN=your_github_token

Create a local.toml file in apps/backend/environments/ (based on the example file).

4. Start the development servers

Frontend:

cd apps/deploy-fe
pnpm dev

5. Connect Your Wallet

The application requires a Laconic wallet for certain operations. You need to set up:

  1. A running wallet instance (follow the setup in the laconic-wallet-web repository)
  2. Configure the NEXT_PUBLIC_WALLET_IFRAME_URL to point to your wallet instance

Architecture

Frontend (Next.js App Router)

The frontend is built with:

  • Next.js 15 with App Router
  • React 19
  • Clerk for authentication
  • TailwindCSS for styling
  • Radix UI components

Authentication Flow (NEEDS DEVELOPMENT!!!)

  1. User authenticates with Clerk (GitHub OAuth)
  2. User connects wallet (Sign-In With Ethereum)
  3. Backend validates and establishes a session

Available Scripts

  • pnpm dev: Start development servers
  • pnpm build: Build all packages
  • pnpm lint: Run linting
  • pnpm check-types: Check TypeScript types

GitHub Authentication

Make sure you have:

  1. Connected your GitHub account in Clerk
  2. Provided the necessary permissions for repository access
  3. Set a fallback GitHub token in .env.local if needed for development