Start with a working screen. Make it yours.
Build from four editable Lumen templates with a shared theme picker. This walkthrough takes you from the live preview to a local project, then through changing the content, testing its interactions, and preparing a static build.
By Santiago Molina ·
1. Choose the screen closest to your project
Open the preview and follow its navigation. Each screen uses public Lumen Astro components, so you can copy a composition, adjust its content, and keep using the same component APIs.
- Landing page introduces a product and connects its calls to action to the other templates.
- Ecommerce combines a product collection with an interactive local cart.
- Dashboard demonstrates metrics that respond to a reporting period.
- Portfolio organizes selected work with category filtering.
Use the theme and appearance controls to compare Lumen, Santi020k, Studio, Paper, Field, Glass, and Harbor. Your selection follows you between the starter's pages.
2. Open your own copy
Download the ZIP or clone the repository to edit your own copy. Use the Node.js and pnpm versions declared in the starter's package.json, then run the commands below.
unzip lumen-astro-starter.zip
cd lumen-astro-starter
pnpm install --frozen-lockfile
pnpm devgit clone https://github.com/santi020k/lumen.git
cd lumen/examples/astro-starter
pnpm install --frozen-lockfile
pnpm devOpen the local address printed by Astro. The starter has its own manifest and lockfile, so its published Lumen dependencies install independently of the contributor workspace. Keep pnpm-lock.yaml when you copy or publish your project.
3. Edit the page you want to keep
The route files in src/pages/ render src/Starter.astro. That shared shell owns navigation, theme selection, and the Lumen runtime. Page content lives in src/components/Landing.astro, Storefront.astro,Dashboard.astro, and Portfolio.astro.
Start with Dashboard.astro. Change its heading to your product's name, replace one metric with a representative value, and check each reporting period. Keep metric labels, values, and chart data consistent as you replace the sample data. Add a small section with public components when you need another content block.
---
import { Badge, Card, Stack } from '@santi020k/lumen-astro'
---
<Card as="section" aria-labelledby="activity-title">
<Stack gap="group">
<h2 id="activity-title">Project activity</h2>
<p>Your team's latest work, in one place.</p>
<Badge variant="outline">Updated today</Badge>
</Stack>
</Card>Adjust layout in src/styles/starter.css. Use semantic roles such ashsl(var(--surface)), hsl(var(--ink)), andhsl(var(--brand)) so your additions respond to every theme. Harbor's editable example stylesheet is src/styles/harbor.css. The shared shell already mounts UIPrimitives once.
After you choose the pages for your site, update navigation and remove unused route files. Set your final title, description, site URL, and links before deploying. Follow the web theme guide when extending the palette.
4. Connect your product's data and services
The cart, reporting periods, and project filters give you concrete interactions to adapt. Keep the user-facing states clear while connecting the starter to your application.
- For ecommerce, connect product availability and server-validated prices, then create checkout sessions through your payment provider.
- For a dashboard, load authorized data for the selected date range and show loading, empty, and failed-request states.
- For a portfolio, replace project examples and destinations with your own work and confirm every category has an appropriate result.
5. Verify and build
Test the changed screens at mobile and desktop widths in both appearance modes. Use Tab and the arrow keys to operate the theme selector and confirm visible focus. Reload and move between routes to check that the chosen theme persists.
- Add multiple products, remove them, and verify that the cart total returns to zero.
- Change the dashboard period and confirm that its metrics and chart agree.
- Choose each portfolio category and return to the full collection.
- Check long labels, enlarged text, and reduced motion after adding your content.
pnpm check
pnpm build
pnpm previewDeploy the generated dist/ directory with a host that supports static Astro sites. The MIT license allows personal and commercial use. Keep its copyright and license notice with copies or substantial portions of the starter.