Monynha Softwares Web Spark

Monynha Softwares Web Spark is a demo web application built with React, Vite and Supabase. It showcases common patterns such as authentication, data fetching and internationalisation using react-i18next. The project is configured to deploy automatically to Vercel via GitHub Actions.

Running locally

1. Install dependencies

   npm install

2. Create a .env file based on .env.example and provide your Supabase credentials.

   cp .env.example .env
   # edit .env and set VITE_SUPABASE_URL and VITE_SUPABASE_ANON_KEY

3. Start the development server

   npm run dev

The application will be available on http://localhost:5173 by default.

Folder structure

src/
  components/      Reusable UI components
  hooks/           Custom React hooks
  integrations/    Third‑party integrations (Supabase)
  pages/           Route components
  lib/             Utility helpers

Scripts

• npm run dev – start the development server
• npm run lint – run ESLint
• npm run test – run unit tests (none at the moment)
• npm run build – create a production build
• npm run sitemap – generate public/sitemap.xml

Environment variables

Create a .env file in the project root with the following entries so the Supabase client can connect to your instance:

VITE_SUPABASE_URL=<your-supabase-url>
VITE_SUPABASE_ANON_KEY=<your-anon-key>

These variables match the placeholders in .env.example.

Technologies

• React & Vite
• TypeScript
• Tailwind CSS & shadcn/ui
• Supabase
• React Query

CI/CD

Pull requests and pushes to main trigger the workflow defined in .github/workflows/deploy.yml. It installs dependencies, lints, runs tests, builds the project and deploys to Vercel. The following secrets must be provided in the GitHub repository settings:

• VERCEL_TOKEN
• VERCEL_ORG_ID
• VERCEL_PROJECT_ID

License

MIT