= await client.contests.getAll();
const contests: Contest[] = response.data.items;
```
---
## FAQ
### How do I get API keys?
Contact Luqta support or sign up at [luqta.com](https://luqta.com) to get your API key and App ID.
### Can I use this without user authentication?
Yes! For public contest listings, you don't need user authentication:
```javascript
const client = new LuqtaClient({
mode: 'custom',
apiKey: 'YOUR_API_KEY',
appId: 'YOUR_APP_ID'
// No user needed
});
await client.initializeSdk();
const contests = await client.contests.getAll();
```
### How do I change the language?
```javascript
// Option 1: During initialization
const client = new LuqtaClient({
// ...
locale: 'ar',
rtl: true
});
// Option 2: After initialization
client.setLocale('ar', true);
await client.refreshUI();
```
### How do I track user actions?
```javascript
const client = new LuqtaClient({
// ...
onAction: (action) => {
switch (action.type) {
case 'contest_joined':
analytics.track('Contest Joined', action.data);
break;
case 'level_completed':
analytics.track('Level Completed', action.data);
break;
case 'quiz_completed':
analytics.track('Quiz Completed', action.data);
break;
}
}
});
```
### Does it work with React/Vue/Angular?
Yes! The SDK is framework-agnostic. See the [Complete Examples](#complete-examples) section for framework-specific code.
### How do I customize the colors?
```javascript
const client = new LuqtaClient({
// ...
branding: {
primaryColor: '#FF5722', // Orange
secondaryColor: '#FF9800', // Light orange
backgroundColor: '#FAFAFA', // Light gray
textColor: '#212121' // Dark gray
}
});
```
### Can I use my own UI?
Yes! Use Custom UI Mode and build your own interface:
```javascript
const client = new LuqtaClient({
mode: 'custom', // API only, no UI
apiKey: 'YOUR_API_KEY',
appId: 'YOUR_APP_ID',
user: { email: 'user@example.com' }
});
await client.initializeUser();
const contests = await client.contests.getAll();
// Now build your own UI with the data
```
### What's the difference between `initializeSdk()` and `initializeUser()`?
- **`initializeSdk()`**: Validates your API key and App ID. No user info needed. Required before fetching contests.
- **`initializeUser()`**: Creates a user session for user-specific actions (participate, complete levels, etc.). Requires at least one identifier (email, phone, username, or uuid).
```javascript
// SDK init (app-level) - always do this first
await client.initializeSdk();
// User init (optional) - only if you need user-specific features
await client.initializeUser();
```
### What is Zero Storage mode?
Zero Storage prevents any readable/plain-text user data from being stored in the database. When enabled (`zeroStorage: true`), the client sends normal data to the server, but the server hashes every field using SHA-256 before storage. Only the hashed values are persisted.
```javascript
// Enable it at client creation
const client = new LuqtaSDK.LuqtaClient({
apiKey: 'YOUR_API_KEY',
appId: 'YOUR_APP_ID',
user: { email: 'user@example.com' },
zeroStorage: true
});
```
Key points:
- No email, phone, name, uuid, or any identifier is stored in readable form
- Hashing is done **server-side** — the client just sends plain data + `zero_storage: true`
- Lookup on subsequent calls uses the same hash formula, so identity is preserved
- If a user was previously synced without zero storage, re-syncing with it enabled automatically clears all old PII columns
See the [Zero Storage Mode](#zero-storage-mode) section for full details.
### What if I get "USER_NOT_SYNCED" error?
This means the user doesn't exist in Luqta yet. Sync them first:
```javascript
try {
await client.initializeUser();
} catch (error) {
if (error.code === 'USER_NOT_SYNCED') {
await client.syncAndInitializeUser({
name: 'User Name',
email: 'user@example.com'
});
}
}
```
### Can I configure the UI after creating the client?
Yes! Use the `configure()` method:
```javascript
const client = new LuqtaClient({
apiKey: 'YOUR_API_KEY',
appId: 'YOUR_APP_ID'
});
await client.initializeSdk();
// Configure UI later
client.configure({
containerId: 'luqta-container',
branding: { primaryColor: '#5304fb' }
});
await client.render();
```
---
## Support
- **Documentation**: [https://luqta.com/docs](https://luqta.com/docs)
- **GitHub Issues**: [https://github.com/luqta/luqta-sdk/issues](https://github.com/luqta/luqta-sdk/issues)
- **Email**: support@luqta.com
---
## License
MIT License - see [LICENSE](LICENSE) for details.
---
Made with care by the Luqta Team
2024-2025 Luqta. All rights reserved.