cardbox / frontend

Cardbox Frontend

Get Started

1. Clone repository

2. Prepare local certificate authorithy

   Setup via mkcert:

   mkcert -install

   Then generate your personal local certificates for cardbox:

   yarn prepare:certs

3. Setup local env for development

   Copy from .env.sample file and make sure the default settings are correct

   # Change some if you need
   RAZZLE_SESSION_TOKEN=XXXXXX
   CLIENT_PUBLIC_PATH=https://localhost:9101/
   PORT=9100
   BACKEND_URL=https://cardbox.sova.dev/api/internal

4. Install and run:

   yarn install
   yarn start

Other commands

yarn api     # update api by codegen
yarn lint    # lint project with fix

Development

HotReload

Sometime you should manually restart server for new changes

# Just type and press ENTER:
rs

Effector

• Use import {} from "effector-root" instead of "effector". All units should be created in the root domain.
• Use import { debug } from "patronum" for debug effector units

Structure

Project designed by FeatureSliced

WIP: Project is migrating from FSv1 to FSv2

app

• src/app/application.tsx — Application component, that have global styles and effector provider
• src/app/server.tsx — Express server, that renders React to stream
• src/app/client.tsx — Browser side entry point, that hydrates stores and react app
• src/index.tsx — Node.js entry point, that have hot module replacement and imports server

pages

• src/pages/index.tsx — Pages component
• src/pages/:page-name/index.tsx — View for single specific page
• src/pages/:page-name/model.ts — Business-logic for specific page, that contains single level logic layer

shared

WIP: soon will be placed at src/shared

• src/lib — Internal libraries
• src/ui — Internal UIKit
• src/lib/effector — START event name to use as page property

frontend's Issues

Main page

https://www.figma.com/file/uJNQc2dQlQTl5O6xEJHdyg/Main?node-id=115%3A0

Card in list — #4
Header and search — #17

Simple user page

https://www.figma.com/file/uJNQc2dQlQTl5O6xEJHdyg/Main?node-id=115%3A326

View card page

https://www.figma.com/file/uJNQc2dQlQTl5O6xEJHdyg/Main?node-id=115%3A424

Implement simple search process

Card in list

• Without tags
• Title
• Short content
• Last update time
• Author name

---

Feature: cards
Component: CardPreview

<CardPreview card={item} />

Home page

https://www.figma.com/file/uJNQc2dQlQTl5O6xEJHdyg/Main?node-id=115%3A0

Do not ran logic on browser after hydrate

accesso-app/frontend@813df4c

Add card page

Setup API connection

Fix sorted of imports

Fix sorted of imports

Setup authentication

Search (without advanced)

Edit card page

Check access rights

• logged or not

Delete card process

Archiving card process

Implemnent Header

• #28
• Logo
• User
• "Create card" button

Searchbar feature

Setup infrastructure