Paul Rastoin
995793c0ac
# Introduction Adding integration test scaffold to the create twenty app and an example to the hello world app This PR also fixes all the sdk e2e tests in local ## `HELLO_WORLD` Removed the legacy implem in the `twenty-apps` folder, replacing it by an exhaustive app generation ## Next step Will in another PR add workflows for CI testing ## Open question - Should we still add vitest config and dep even if the user did not ask for the integration test example ? -> currently we don't - That's the perfect timing to identify if we're ok to handle seed workspace authentication with the known api key
63 lines
2.1 KiB
Markdown
63 lines
2.1 KiB
Markdown
This is a [Twenty](https://twenty.com) application project bootstrapped with [`create-twenty-app`](https://www.npmjs.com/package/create-twenty-app).
|
|
|
|
## Getting Started
|
|
|
|
First, authenticate to your workspace:
|
|
|
|
```bash
|
|
yarn twenty auth:login
|
|
```
|
|
|
|
Then, start development mode to sync your app and watch for changes:
|
|
|
|
```bash
|
|
yarn twenty app:dev
|
|
```
|
|
|
|
Open your Twenty instance and go to `/settings/applications` section to see the result.
|
|
|
|
## Available Commands
|
|
|
|
Run `yarn twenty help` to list all available commands. Common commands:
|
|
|
|
```bash
|
|
# Authentication
|
|
yarn twenty auth:login # Authenticate with Twenty
|
|
yarn twenty auth:logout # Remove credentials
|
|
yarn twenty auth:status # Check auth status
|
|
yarn twenty auth:switch # Switch default workspace
|
|
yarn twenty auth:list # List all configured workspaces
|
|
|
|
# Application
|
|
yarn twenty app:dev # Start dev mode (watch, build, sync, and auto-generate typed client)
|
|
yarn twenty entity:add # Add a new entity (object, field, function, front-component, role, view, navigation-menu-item)
|
|
yarn twenty function:logs # Stream function logs
|
|
yarn twenty function:execute # Execute a function with JSON payload
|
|
yarn twenty app:uninstall # Uninstall app from workspace
|
|
```
|
|
|
|
## Integration Tests
|
|
|
|
If your project includes the example integration test (`src/__tests__/app-install.integration-test.ts`), you can run it with:
|
|
|
|
```bash
|
|
# Make sure a Twenty server is running at http://localhost:3000
|
|
yarn test
|
|
```
|
|
|
|
The test builds and installs the app, then verifies it appears in the applications list. Test configuration (API URL and API key) is defined in `vitest.config.ts`.
|
|
|
|
## LLMs instructions
|
|
|
|
Main docs and pitfalls are available in LLMS.md file.
|
|
|
|
## Learn More
|
|
|
|
To learn more about Twenty applications, take a look at the following resources:
|
|
|
|
- [twenty-sdk](https://www.npmjs.com/package/twenty-sdk) - learn about `twenty-sdk` tool.
|
|
- [Twenty doc](https://docs.twenty.com/) - Twenty's documentation.
|
|
- Join our [Discord](https://discord.gg/cx5n4Jzs57)
|
|
|
|
You can check out [the Twenty GitHub repository](https://github.com/twentyhq/twenty) - your feedback and contributions are welcome!
|