A production-ready frontend for a service booking platform in Ethiopia, built with Next.js 14, TailwindCSS, and TypeScript.
Follow these steps to get the project running on your local machine.
- Node.js (v18 or v20 LTS recommended)
- npm, yarn, or pnpm
Clone the repository (if you haven't already) and install dependencies:
npm install
# or
yarn install
# or
pnpm installCopy the example environment file to create your local environment configuration:
cp .env.example .env.localOpen .env.local and update the variables if you have your Supabase credentials ready. For now, the default placeholders will work for the UI.
Start the local development server:
npm run devOpen http://localhost:3000 with your browser to see the result.
- Framework: Next.js 14 (App Router)
- Language: TypeScript
- Styling: Tailwind CSS
- UI Components: ShadCN UI
- State Management: Zustand
- Data Fetching: React Query
- Backend/Auth: Supabase
src/
├── app/ # Next.js App Router pages
├── components/ # React components
│ ├── ui/ # ShadCN UI primitives
│ ├── shared/ # Reusable components
│ └── features/ # Feature-specific components
├── lib/ # Utilities and libraries setup (Axios, React Query)
├── store/ # Zustand state stores
├── types/ # Global TypeScript interfaces
└── utils/ # Helper functions