Quespotμ κ΄κ΄μ§λ₯Ό νμνκ³ , μ§μλ³ λ―Έμ μ μννλ©°, μ¬νμ κ²½νμ κΈ°λ‘ν μ μλ λ―Έμ ν κ΄κ΄ μλΉμ€μ λλ€.
μ¬μ©μλ νμ¬ μμΉ λλ μ νν μ§μμ κΈ°λ°μΌλ‘ κ΄κ΄μ§μ μΆμ² μ½μ€λ₯Ό νμΈνκ³ , μ¬μ§ μΈμ¦Β·ν€μλ μ λ ₯Β·κ°μ κΈ°λ‘ λ±μ λ―Έμ μ μνν μ μμ΅λλ€.
λ―Έμ μ μλ£νλ©΄ ν¬μΈνΈμ λ°°μ§, μ§μ μ€ν¬νλ₯Ό νλνκ³ μ¬ν κΈ°λ‘μ μμΉ΄μ΄λΈμ λ¨κΈΈ μ μμ΅λλ€.
- νμ¬ μμΉ λ° μ νν μ§μμ κΈ°λ°μΌλ‘ κ΄κ΄μ§ νμ
- κ΄κ΄μ§ μμΉ λ° μμΈ μ 보 νμΈ
- λμ΄λμ ν λ§λ₯Ό κ³ λ €ν λ―Έμ μ½μ€ νμ
- Google Maps κΈ°λ° μ§λ μΈν°νμ΄μ€
λ¨μν κ΄κ΄μ§λ₯Ό λ°©λ¬Ένλ κ²μμ λμκ°, κ΄κ΄μ§λ₯Ό μ§μ κ΄μ°°νκ³ κ²½νν μ μλλ‘ λ―Έμ μ μ 곡ν©λλ€.
| λ―Έμ μ ν | μ€λͺ |
|---|---|
| πΈ μ¬μ§ μΈμ¦ | μ£Όμ΄μ§ μ₯μλ ꡬλλ₯Ό μ°Έκ³ νμ¬ μ¬μ§ 촬μ |
| π ν€μλ κ΄μ°° | κ΄κ΄μ§μμ νΉμ μμλ₯Ό λ°κ²¬νκ³ κΈ°λ‘ |
| βοΈ κ°μ κΈ°λ‘ | λ°©λ¬Έ μ₯μμ λν μκ°κ³Ό κ²½ν μμ± |
- κ΄κ΄ μ½μ€λ³ λ―Έμ νμΈ
- λ―Έμ μμΈ μ 보 λ° μν νλ©΄ μ 곡
- GPS λ° μ΄λ―Έμ§ κΈ°λ° μΈμ¦ κΈ°λ₯
- μΈμ¦ κ²°κ³Όμ λ°λ₯Έ νλ©΄ μ ν
- λ―Έμ μνμ λ°λ₯Έ ν¬μΈνΈ νλ
- λ―Έμ μλ£ λ³΄μ νμΈ
- μ§μλ³ μ€ν¬ν λ° λ°°μ§ μμ§
- κ΄κ΄ νλμ λν μ±μ·¨ κ²½ν μ 곡
- μνν λ―Έμ λ° μ¬ν κΈ°λ‘ νμΈ
- κ΄κ΄μ§λ³ νλ μ΄λ ₯ κ΄λ¦¬
- μ¬ν κΈ°λ‘κ³Ό 보μ λ΄μ νμΈ
- μ¬ν κ²½νμ 곡μ ν μ μλ μΉ΄λ κΈ°λ₯
- λ―Έμ κ΄λ ¨ μλ¦Ό
- 보μ νλ μλ¦Ό
- μΆμ² κ΄κ΄μ§ λ° μλΉμ€ μλ¦Ό
| Category | Technologies |
|---|---|
| Language | TypeScript |
| Framework | React 19 |
| Build Tool | Vite |
| Styling | Tailwind CSS v4 |
| Routing | React Router DOM |
| Server State | TanStack Query v5 |
| HTTP Client | Axios |
| Maps | Google Maps, @vis.gl/react-google-maps |
| External Service | Firebase |
| PWA | vite-plugin-pwa |
| SVG | SVGR |
| UI Icons | Lucide React |
| Package Manager | pnpm |
| Deployment | Vercel |
Quespotμ κ΄κ΄μ§ νμλΆν° λ―Έμ μν, μΈμ¦, 보μ λ° μμΉ΄μ΄λΈκΉμ§ μ°κ²°λλ μ¬μ©μ νλ¦μ μ€μ¬μΌλ‘ ꡬμ±λ React κΈ°λ° μΉ μ ν리μΌμ΄μ μ λλ€.
κ³΅ν΅ λ μ΄μμκ³Ό λΌμ°ν μ λΆλ¦¬νκ³ , μλ² λ°μ΄ν°μ UI μνμ μν μ ꡬλΆνμ¬ μ¬λ¬ κΈ°λ₯μ κ΄λ¦¬ν μ μλλ‘ κ΅¬μ±νμ΅λλ€.
React Routerμ createBrowserRouterλ₯Ό νμ©νμ¬ μ ν리μΌμ΄μ
λΌμ°ν
μ ꡬμ±νμ΅λλ€.
μ£Όμ ꡬμ±
MobileLayout: λͺ¨λ°μΌ μΉ νκ²½μ κ³΅ν΅ λ μ΄μμBottomNavigationLayout: νλ¨ λ΄λΉκ²μ΄μ μ μ¬μ©νλ νμ΄μ§μ κ³΅ν΅ λ μ΄μμProtectedRoute: μΈμ¦μ΄ νμν νμ΄μ§μ λν μ κ·Ό μ μ΄PATH: νμ΄μ§ κ²½λ‘λ₯Ό λ³λλ‘ κ΄λ¦¬νκΈ° μν μμ
κ³΅ν΅ UIλ₯Ό λ μ΄μμ λ¨μλ‘ λΆλ¦¬νμ¬ νμ΄μ§λ§λ€ λμΌν λ΄λΉκ²μ΄μ κ³Ό νλ©΄ ꡬ쑰λ₯Ό λ°λ³΅ν΄μ μμ±νμ§ μλλ‘ κ΅¬μ±νμ΅λλ€.
λν μΈμ¦μ΄ νμν νλ©΄μ μ κ·Ό 쑰건μ λΌμ°ν κ³μΈ΅μμ κ΄λ¦¬ν μ μλλ‘ λΆλ¦¬νμ΅λλ€.
TanStack Query v5λ₯Ό νμ©ν μλ² μν κ΄λ¦¬ νκ²½μ ꡬμ±νμ΅λλ€.
μ£Όμ ꡬμ±
- μ ν리μΌμ΄μ
μ΅μμμ
QueryClientProviderμ μ© QueryClientλ₯Ό ν΅ν μλ² μν κ΄λ¦¬ κΈ°λ° κ΅¬μ±- Axiosλ₯Ό νμ©ν HTTP ν΅μ
- API λ°μ΄ν° μ²λ¦¬μ UI λ λλ§ κ΄μ¬μ¬ λΆλ¦¬
μ΄λ₯Ό ν΅ν΄ κ΄κ΄μ§, λ―Έμ , μ¬μ©μ μ 보 λ± μλ²μ μ°λλλ λ°μ΄ν°λ₯Ό λ€λ£° μ μλ κΈ°λ°μ λ§λ ¨νμ΅λλ€.
vite-plugin-pwaλ₯Ό νμ©νμ¬ λͺ¨λ°μΌ νκ²½μμ μ±κ³Ό μ μ¬ν μ¬μ©μ κ²½νμ μ 곡νκΈ° μν PWA μ€μ μ ꡬμ±νμ΅λλ€.
μ μ© μ€μ
- Web App Manifest λ±λ‘
standaloneλμ€νλ μ΄ λͺ¨λautoUpdateλ±λ‘ λ°©μ μ€μ
PWA μ€μ μ ν΅ν΄ λͺ¨λ°μΌ κΈ°κΈ°μμ ν νλ©΄μ μΆκ°νμ¬ μ¬μ©ν μ μλ μΉμ± νκ²½μ μ§μνλλ‘ κ΅¬μ±νμ΅λλ€.
Viteμ TypeScriptλ₯Ό κΈ°λ°μΌλ‘ νλ‘μ νΈλ₯Ό ꡬμ±νμ΅λλ€.
- TypeScriptμ μ격ν νμ κ²μ¬ μ€μ
@/aliasλ₯Ό ν΅ν μ λ κ²½λ‘ κΈ°λ° λͺ¨λ μ°Έμ‘°- Tailwind CSS v4 κΈ°λ° μ€νμΌλ§
- SVGRμ νμ©ν SVG μ»΄ν¬λνΈ μ¬μ©
- pnpmμ νμ©ν ν¨ν€μ§ κ΄λ¦¬
μ§μ μ ν / νμ¬ μμΉ
β
κ΄κ΄μ§ λ° μ½μ€ νμ
β
λ―Έμ
μμΈ
β
λ―Έμ
μν
β
μ¬μ§ / ν€μλ / κ°μ μΈμ¦
β
μΈμ¦ κ²°κ³Ό
β
보μ νλ
β
μ¬ν μμΉ΄μ΄λΈ
μ¬μ©μκ° κ΄μ¬ μλ μ§μμ μ ννκ³ , κ΄κ΄μ§μ μΆμ² λ―Έμ μ½μ€λ₯Ό νμΈν©λλ€.
μ νν κ΄κ΄ μ½μ€μ ν¬ν¨λ λ―Έμ μ μνν©λλ€.
λ―Έμ μ μ’ λ₯μ λ°λΌ μ¬μ§ 촬μ, ν€μλ μ λ ₯, κ°μ μμ± λ±μ μΈν°νμ΄μ€λ₯Ό μ 곡ν©λλ€.
μ¬μ©μκ° μ μΆν μΈμ¦ μ 보μ λ°λΌ μΈμ¦ κ³Όμ μ μ§ννκ³ κ²°κ³Όλ₯Ό νμΈν©λλ€.
μΈμ¦ μ§ν μνμ λ°λΌ λ‘λ© λ° κ²°κ³Ό νλ©΄μ μ 곡ν©λλ€.
λ―Έμ μν κ²°κ³Όμ λ°λ₯Έ 보μμ νμΈνκ³ , μ¬μ©μμ μ¬ν νλμ μμΉ΄μ΄λΈμ κΈ°λ‘ν©λλ€.
μ£Όμ λλ ν°λ¦¬μ νμΌμ μ€μ¬μΌλ‘ μ 리ν νλ‘μ νΈ κ΅¬μ‘°μ λλ€.
Quespot-FE/
βββ public/ # μ μ 리μμ€ λ° PWA μμ΄μ½
βββ scripts/ # νλ‘μ νΈ μ€ν¬λ¦½νΈ
βββ src/
β βββ assets/ # μ΄λ―Έμ§ λ° SVG μμ
β βββ components/ # κ³΅ν΅ λ° κΈ°λ₯λ³ μ»΄ν¬λνΈ
β βββ layouts/ # κ³΅ν΅ λ μ΄μμ
β β βββ MobileLayout
β β βββ BottomNavigationLayout
β βββ pages/ # κΈ°λ₯λ³ νμ΄μ§
β β βββ Auth/ # λ‘κ·ΈμΈ, νμκ°μ
, μ¨λ³΄λ©
β β βββ mission/ # λ―Έμ
νμ, μμΈ, μ½μ€
β β β βββ verify/ # λ―Έμ
μΈμ¦ λ° κ²°κ³Ό
β β βββ map/ # μ§λ λ° μ₯μ κ²μ
β β βββ My/ # λ§μ΄νμ΄μ§ λ° μμΉ΄μ΄λΈ
β β βββ HomePage
β β βββ RewardPage
β β βββ NotificationPage
β βββ routes/ # λΌμ°ν
λ° μ κ·Ό μ μ΄
β β βββ router.tsx
β β βββ paths.ts
β β βββ ProtectedRoute
β βββ styles/ # μ€νμΌ κ΄λ ¨ νμΌ
β βββ App.tsx # μ± μ»΄ν¬λνΈ
β βββ main.tsx # μ± μ§μ
μ λ° Provider
βββ index.html
βββ package.json
βββ tsconfig.json
βββ vercel.json
βββ vite.config.ts
νλ‘μ νΈμ λΉλ νκ²½μ Viteλ₯Ό κΈ°λ°μΌλ‘ ꡬμ±λμ΄ μμ΅λλ€.
μ μ© νλ¬κ·ΈμΈ
@vitejs/plugin-react: React κ°λ°νκ²½@tailwindcss/vite: Tailwind CSS ν΅ν©vite-plugin-svgr: SVG μ»΄ν¬λνΈ μ¬μ©vite-plugin-pwa: PWA μ€μ λ° Manifest μμ±
TypeScriptλ₯Ό νμ©ν΄ μ»΄ν¬λνΈμ λ°μ΄ν° ꡬ쑰μ νμ μμ μ±μ ν보νκ³ , λΉλ κ³Όμ μμ νμ κ²μ¬λ₯Ό μννλλ‘ μ€μ νμ΅λλ€.
- Vite κΈ°λ° κ°λ° μλ² μ€ν
tsc && vite buildλ₯Ό ν΅ν νμ κ²μ¬ λ° νλ‘λμ λΉλ- Vercelμ ν΅ν μΉ μλΉμ€ λ°°ν¬
- SPA λΌμ°ν μ μν λ°°ν¬ νκ²½ μ€μ
| Name | GitHub |
|---|---|
| κΉμ¬λ² | @kinjaebeom |
| κ°λ―Όμ | @shooukie |
| μ΅ν¨λΉ | @Hyobee02 |
- Service: https://quespot.site
- Frontend Repository: https://github.com/Quespot/FE
Quespotμ μ¬μ©μκ° κ΄κ΄μ§λ₯Ό μ§μ νμνκ³ , λ―Έμ μ μννλ©°, μ¬ν κ²½νμ κΈ°λ‘νλ κ³Όμ μ νλμ μλΉμ€λ‘ μ°κ²°ν νλ‘μ νΈμ λλ€.