A full-featured CRM built with React, shadcn/ui, and Supabase.
Merge branch 'main' into feat/task-list
Anthony Rimet11021426fa15
diff --cc README.mdindex e07dfe97,1314f820..bc3fb7a7--- a/README.md+++ b/README.md@@@ -106,139 -115,43 +114,181 @@@ GIT_USER_NAME: The deploy account's namGIT_USER_EMAIL: The deploy user's email```+## Customizing++You can customize the title, logo, theme, and domain of the CRM app by passing custom props to the `<CRM>` component:++```tsx+// App.tsx+import React from 'react';+import CRM from './CRM';++const App = () => (+ <CRM+ title="Custom CRM Title"+ logo="custom-logo.png"+ />+);++export default App;+```++## Domain & Process++In addition to the design, you can easily customize various aspects relevant to your business domain. The behavior is the same as described above. You can modify the following:++| Props | Description | Type |+|-----------------------|-----------------------------------------------------------------------|-----------------|+| contactGender | The gender options for contacts used in the application. | ContactGender[] |+| companySectors | The list of company sectors used in the application. | string[] |+| darkTheme | The theme to use when the application is in dark mode. | RaThemeOptions |+| dealCategories | The categories of deals used in the application. | string[] |+| dealPipelineStatuses | The statuses of deals in the pipeline used in the application | string[] |+| dealStages | The stages of deals used in the application. | DealStage[] |+| lightTheme | The theme to use when the application is in light mode. | RaThemeOptions |+| logo | The logo used in the CRM application. | string |+| noteStatuses | The statuses of notes used in the application. | NoteStatus[] |+| taskTypes | The types of tasks used in the application. | string[] |+| title | The title of the CRM application. | string |++```tsx+import { CRM } from './root/CRM';+import { ThemeOptions } from '@mui/material/styles';++const lightTheme: ThemeOptions = {+ palette: {+ mode: 'light',+ },+};++const darkTheme: ThemeOptions = {+ palette: {+ mode: 'dark',+ },+};++const App = () => {+ return (+ <CRM+ contactGender={[+ { value: 'male', label: 'He' },+ { value: 'female', label: 'She' },+ ]}+ companySectors={['Technology', 'Finance']}+ darkTheme={darkTheme}+ dealCategories={['Copywriting', 'Design']}+ dealPipelineStatuses={['won']}+ dealStages={[+ { value: 'opportunity', label: 'Opportunity' },+ { value: 'proposal-sent', label: 'Proposal Sent' },+ { value: 'won', label: 'Won' },+ { value: 'lost', label: 'Lost' },+ ]}+ lightTheme={lightTheme}+ logo="https://example.com/logo.png"+ noteStatuses={[+ { value: 'cold', label: 'Cold', color: '#7dbde8' },+ { value: 'warm', label: 'Warm', color: '#e8cb7d' },+ { value: 'hot', label: 'Hot', color: '#e88b7d' },+ ]}+ taskTypes={['Call', 'Email', 'Meeting']}+ title="CRM Dashboard"+ />+ );+};++export default App;+```++## Adding Sales++To add a new sale to the CRM, you need to use an administrator account. By default, the first account created has this role. If you are starting fresh, a sign-up page will prompt you to create this admin account.++When logged in as an admin, an 'Account Manager' tab will be available. From this page, you can create sales and transfer the administrator role.+++++## Customizing the Homepage++The first page of the application is managed by the `Dashboard.tsx` component. You can customize it by updating this file.++```jsx+// ./src/dashboard/Dashboard.tsx+import React from 'react';+import { Card, CardContent, Typography } from '@mui/material';++export const Dashboard = () => {+ return (+ <Card>+ <CardContent>+ <Typography variant="h5" component="div">+ Welcome to the Custom Dashboard!+ </Typography>+ <Typography variant="body2" color="text.secondary">+ This is a customized homepage for your application. You can add any components or content here to suit your needs.+ </Typography>+ </CardContent>+ </Card>+ );+};+```+- ## Migrations+ ## Supabase+++### Migrations++You can create a new migration using the following command:+```sh+npx supabase migration new <migration_name>+```++You can apply the migrations using the following command:+```sh+npx supabase migration up+```++But you can also apply changes in the database directly using the supabase Dashboard.+Create a new migration using the following command:+```sh- npx supabase db diff | npx supabase migration new <migration_name>++npx supabase db diff | npx supabase migration new <migration_name>++```+++ ### Password Reset When Forgotten+ If users forgot their password, they can request for a reset. Atomic CRM handle it for you. All the magic is done by the custom route `/forgot-password` and `/set-password` that you can find in the `CRM` component.++ If you want to update default configuration:++ ### Local development++ 1. Go to your `config.toml` file+ 2. In `[auth]` section set `site_url` to your application URL+ 3. In `[auth]`, add the following URL in the `additional_redirect_urls = [{APPLICATION_URL}}/auth-callback"]`+ 4. Add an `[auth.email.template.recovery]` section with the following option+ ```+ [auth.email.template.recovery]+ subject = "Reset Password"+ content_path = "./supabase/templates/recovery.html"+ ```++ In Recovery email template set the `auth-callback` redirection++ ```HTML+ <html>+ <body>+ <h2>Reset Password</h2>+ <p><a href="{{ .ConfirmationURL }}/auth-callback">Reset your password</a></p>+ </body>+ </html>+ ```++ Supabase provides an [Inbucket](https://inbucket.org/) instance that allows you to test your emails and configure your flow.++ ### Production++ This requires you to configure your supabase instance:++ 1. Go to your dashboard Authentication section+ 2. In URL Configuration, set Site URL to your application URL+ 3. In URL Configuration, add the following URL in the Redirect URLs section: `YOUR_APPLICATION_URL/auth-callback`-4. In Email Templates, change the `"{{ .ConfirmationURL }}"` to `"{{ .ConfirmationURL }}/auth-callback"`++4. In Email Templates, change the `"{{ .ConfirmationURL }}"` to `"{{ .ConfirmationURL }}/auth-callback"`