# Create a new website
Start from nothing. This gives you the standard project layout and no opinions
about content or styling.
## 1. Scaffold
```bash
epresso init mysite
cd mysite
```
`init` creates:
```tree
mysite/
site.toml # configuration
content.config.py # collection definitions (empty template)
content/ # collection data (markdown / JSON / YAML / TOML)
pages/ # routes
index.ep
layouts/
Base.ep # the HTML shell, exposes
components/ # reusable components
styles/ # global stylesheets
public/ # files copied verbatim to the output root
```
Build it immediately:
```bash
epresso build # ✅ Built 1 pages … → dist/
epresso dev # http://127.0.0.1:4321, live reload
```
## 2. Make it yours
Edit `site.toml` — at minimum the name and URL:
```toml
[site]
name = "My Site"
url = "https://example.com"
language = "en"
[build]
trailing_slash = "always"
```
`pages/index.ep` is a single file: Python frontmatter between `---` fences,
then a Jinja body. It renders inside `layouts/Base.ep` through the ``
component:
```epresso
---
---
Hello, epresso!
This is your first page.
```
## 3. Add a page
Create `pages/about.ep`:
```epresso
---
---
About
Written in a single file.
```
It becomes `/about/` automatically — the filesystem path *is* the route. See
[Pages](../basics/pages.md) and [Routing](../basics/routing.md) for dynamic
routes (`[slug].ep`), endpoints (`.py`) and direct Markdown pages (`.md`).
## 4. Add a component
A component is also one file, but it may declare a typed `Props` model and a
scoped `
{% if props.href %}{{ props.title }}
{% else %}{{ props.title }}{% endif %}
{{ content }}
```
Save it as `components/Card.ep` and use it from any page:
```epresso
Body text goes in the default slot.
```
The `