# Native Lark Dashboard Creation - Start Here
## Overview
This documentation set provides everything you need to create a native TikTok analytics dashboard directly in Lark Base.
**Base URL:** https://hypelive.sg.larksuite.com/base/C8kmbTsqoa6rBesTKRpl8nV8gHd
---
## Quick Navigation
### I want to create the dashboard NOW (15 minutes)
**START HERE:** [QUICK_START_CHECKLIST.md](QUICK_START_CHECKLIST.md)
This is your step-by-step guide with minute-by-minute instructions. Just follow the checklist and you'll have a working dashboard in 15-20 minutes.
---
### I want to understand the complete process first
**READ THIS:** [CREATE_DASHBOARD_NOW.md](CREATE_DASHBOARD_NOW.md)
Comprehensive guide covering:
- Why API can't create dashboards
- 10 recommended chart configurations
- Advanced features and tips
- Troubleshooting guide
- Best practices
---
### I need field names and technical details
**REFERENCE THIS:** [FIELD_REFERENCE.md](FIELD_REFERENCE.md)
Complete technical reference:
- All 20 field names and IDs
- Field types and formats
- Recommended aggregations
- API access examples
- Quick copy-paste field names
---
### I want to see what the final dashboard looks like
**CHECK THIS:** [DASHBOARD_MOCKUP.md](DASHBOARD_MOCKUP.md)
Visual blueprint showing:
- ASCII art layout mockup
- Chart-by-chart breakdown
- Color schemes and styling
- Interactive features
- Mobile responsive design
---
### I want a high-level summary
**READ THIS:** [DASHBOARD_SUMMARY.md](DASHBOARD_SUMMARY.md)
Executive summary covering:
- API capabilities and limitations
- Current base state (150 videos, 20 fields)
- Recommended dashboard structure
- Implementation timeline
- ROI and business value
---
## File Guide
| File | Purpose | Use When |
|------|---------|----------|
| QUICK_START_CHECKLIST.md | Fast creation guide | You want to build NOW |
| CREATE_DASHBOARD_NOW.md | Complete manual | You want full details |
| FIELD_REFERENCE.md | Technical reference | You need field names |
| DASHBOARD_MOCKUP.md | Visual design guide | You want to see layout |
| DASHBOARD_SUMMARY.md | Executive overview | You need high-level info |
---
## Key Facts
### What You Need to Know
- **API Limitation:** Lark API cannot create dashboard views programmatically
- **Manual Creation Required:** Must use Lark UI to create dashboards
- **Time Required:** 15-20 minutes following the checklist
- **Data Ready:** All 150 TikTok videos properly formatted
- **Fields Available:** 20 fields including views, likes, comments, shares, watch %
### What You Get
- 5 KPI metric cards (total views, likes, comments, shares, avg watch %)
- Views & engagement trend chart
- Top 10 videos performance chart
- Watch completion analysis
- Recent performance table
- Optional: Distribution charts, engagement breakdowns
### Available API View Types
The Lark API supports creating these view types programmatically:
- Grid (table view)
- Kanban (board view)
- Gallery (card view)
- Gantt (timeline view)
- Form (data entry view)
**Dashboard views are NOT supported via API** and must be created through the UI.
---
## Implementation Paths
### Path 1: Quick Manual Creation (Recommended)
**Time:** 15-20 minutes
**Tools:** Lark UI only
**Guide:** QUICK_START_CHECKLIST.md
**Result:** Native Lark dashboard with full features
**Steps:**
1. Open base URL
2. Create new dashboard view
3. Add 5 KPI cards
4. Add 3-4 charts
5. Add performance table
6. Share with team
---
### Path 2: Comprehensive Manual Creation
**Time:** 30-40 minutes
**Tools:** Lark UI + calculated fields
**Guide:** CREATE_DASHBOARD_NOW.md
**Result:** Advanced dashboard with custom metrics
**Steps:**
1. Create calculated fields (engagement rate, virality score)
2. Build all 10 recommended charts
3. Configure filters and interactions
4. Set up color coding
5. Add drill-down features
6. Create shareable link
---
### Path 3: External BI Dashboard
**Time:** 2-4 hours
**Tools:** API + external BI tool (Tableau, Power BI, etc.)
**Guide:** Use FIELD_REFERENCE.md for API access
**Result:** Custom external dashboard
**Steps:**
1. Use API to fetch all 150 records
2. Export to CSV or connect directly
3. Build custom dashboard in BI tool
4. Schedule automatic data refresh
5. Share/embed dashboard
**Note:** This path requires external tools and ongoing maintenance.
---
## Decision Matrix
Choose your path based on your needs:
| Need | Recommended Path | File to Use |
|------|-----------------|-------------|
| Dashboard in 15 min | Quick Manual | QUICK_START_CHECKLIST.md |
| Complete native dashboard | Comprehensive Manual | CREATE_DASHBOARD_NOW.md |
| Custom external analytics | External BI | FIELD_REFERENCE.md |
| Just understand options | Executive summary | DASHBOARD_SUMMARY.md |
| See visual design | Design reference | DASHBOARD_MOCKUP.md |
---
## Data Overview
### Base Details
- **App Token:** C8kmbTsqoa6rBesTKRpl8nV8gHd
- **Table Name:** TikTok L'AURA - Candle
- **Table ID:** tblG4uuUvbwfvI9Z
- **Total Records:** 150 videos
- **Existing Views:** 2 (both grid type)
### Key Metrics Available
- Total video views
- Total likes, comments, shares
- Video duration
- Watch completion percentage
- Unique viewers
- Average/total watch time
- Publication date/time
- Geographic distribution
- Traffic sources
### Data Quality
- All records complete (no missing data)
- Proper data types
- Consistent formatting
- Ready for immediate visualization
---
## Quick Start Commands
### For Immediate Action
```bash
# Step 1: Open this URL in browser
open https://hypelive.sg.larksuite.com/base/C8kmbTsqoa6rBesTKRpl8nV8gHd
# Step 2: Open the quick start guide
open /Users/mdch/hype-dash/QUICK_START_CHECKLIST.md
# Step 3: Have field reference handy
open /Users/mdch/hype-dash/FIELD_REFERENCE.md
```
---
## Success Criteria
Your dashboard is ready when you can answer:
**Content Performance Questions:**
- Which videos have the most views?
- What's the average watch completion rate?
- How do engagement metrics trend over time?
- Which video length performs best?
**Audience Behavior Questions:**
- How long do viewers watch on average?
- What percentage complete videos?
- When is the best time to post?
- Which content drives the most shares?
**Optimization Questions:**
- Which videos should be promoted?
- What content format works best?
- Where are improvement opportunities?
- What's the ROI per video?
---
## Common Questions
### Can I create the dashboard programmatically?
No, the Lark API does not support creating dashboard views. You must use the UI.
### How long will it take?
15-20 minutes following QUICK_START_CHECKLIST.md, or 30-40 minutes for the comprehensive version in CREATE_DASHBOARD_NOW.md.
### Do I need coding skills?
No, all dashboard creation is done through the Lark UI (point and click).
### Can I automate data updates?
Yes, the dashboard automatically shows the latest data from your table. No manual refresh needed.
### Can I share the dashboard?
Yes, use Lark's built-in sharing to create view-only or edit links.
### Will it work on mobile?
Yes, dashboards are responsive. However, creation is best done on desktop.
---
## Support Resources
### Documentation Files (This Folder)
- QUICK_START_CHECKLIST.md - Fast creation guide
- CREATE_DASHBOARD_NOW.md - Complete manual
- FIELD_REFERENCE.md - Technical reference
- DASHBOARD_MOCKUP.md - Visual design guide
- DASHBOARD_SUMMARY.md - Executive summary
### External Resources
- Lark Help Center: https://www.larksuite.com/help
- API Documentation: https://open.larksuite.com/document/
- Community Forum: https://forum.larksuite.com/
- Support Email: support@larksuite.com
---
## Next Steps
### Right Now (5 minutes)
1. Open the base URL above
2. Verify you can access the 150 video records
3. Review QUICK_START_CHECKLIST.md
4. Bookmark this index for reference
### Today (20 minutes)
1. Follow QUICK_START_CHECKLIST.md
2. Create basic dashboard with KPIs and charts
3. Share with one team member for feedback
4. Make quick adjustments
### This Week (1 hour)
1. Review CREATE_DASHBOARD_NOW.md for advanced features
2. Add calculated fields and additional charts
3. Set up filters and interactions
4. Train team on dashboard usage
### This Month (Ongoing)
1. Monitor dashboard daily/weekly
2. Analyze trends and patterns
3. Optimize content strategy based on insights
4. Iterate on dashboard design
---
## Final Recommendation
**For fastest results:**
1. Open this file: [QUICK_START_CHECKLIST.md](QUICK_START_CHECKLIST.md)
2. Open the base: https://hypelive.sg.larksuite.com/base/C8kmbTsqoa6rBesTKRpl8nV8gHd
3. Follow the 7-phase checklist
4. Have [FIELD_REFERENCE.md](FIELD_REFERENCE.md) open for copy-pasting field names
**Total time:** 15-20 minutes
**Result:** Fully functional TikTok analytics dashboard
Good luck!
